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WARNING 





The Data Dictionary integrity can be destroyed by using a utility 
that is not listed below. Therefore, only the following utilities 
will be supported by Hewlett-Packard when used against the Data 
Dictionary: 


DICTINIT 
DICTDBM 
DICTDBM , UTIL 
DICTDBD 

DICTDBA 

DICTDBC 
DBSTORE/DBRESTOR 
* STORE/RESTORE 

* SYSDUMP 


Hewlett-Packard will investigate and attempt to resolve problems 
resulting from the use of utilities that do not appear on the above 
list. This service is not provided under HP's standard support 
agreements, but is available on a time and material basis. 


HEWLETT-PACKARD IS NOT RESPONSIBLE FOR ANY LOSS OR DAMAGE RESULTING 
FROM CUSTOMER'S USE OF THE DATA DICTIONARY WITH UTILITIES NOT 
LISTED ABOVE. 


*NOTE: STORE/RESTORE and SYSDUMP will be supported only when used 
on the Data Dictionary in its entirety (e.g., the root file 
and all data sets). 


NOTICE 


The information contained in this document is subject to change 
without notice. . 


HEWLETT-PACKARD MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS 
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. 
Hewlett-Packard shall not be liable for errors contained herein or 
for incidental or consequential damages in. connection with the 
furnishing, performance or use of this material. 


This document contains proprietary information which is protected 
by copyright. All right are reserved. No part of this document 
may be photocopied or reproduced without the prior written consent 
of Hewlett-Packard Company. 


Copyright ©1982 by HEWLETT-PACKARD COMPANY 
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PREFACE 


This manual describes the Dictionary/3000 software system that operates on HP 
3000 computers. It is the reference document for all persons involved in 
creating and maintaining a dictionary data base and an IMAGE/3000 data base. 
It assumes a working knowledge of the HP 3000 computer system, including the 
subsystem IMAGE/3000. 


NOTE 

Once Dictionary/3000 software has been installed on your 
system, you must execute the program DICTINIT to create 
and initialize your data dictionary. This program is 
described in Appendix C. DICINIT also allows you to 
re-initialize an existing data dictionary in order to 
change the passwords for access or the capacities of the 
data sets in the dictionary. 


The following is a list of reference manuals and self-paced courses you may 
want as a supplement to this manual: 


Manual Part Number 
MPE Command Reference Manual 30000-90009 
MPE Error Messages and Recovery Manual 30000-90015 
Using Files 30000-90102 
IMAGE/3000 Reference Manual ' 32215-90003 
VPLUS/3000 Reference Manual 32209-90001 
KSAM/3000 Reference Manual 30000-90079 
Transact/3000 Reference Manual 32247-90001 
HP Inform/3000 User's Guide 32246-90001 

Self-Paced Course Product Number 
Programming in Transact /3000 22842A 
Using Dictionary/3000 22843A 





|CONVENTIONS 


NOTATION 


{ } 


italics 


upper case 


DESCRIPTION 


An element inside brackets is optional. Several elements 
stacked inside a pair of brackets means the user may select 
any one or none of these elements. 


Example: [A] User may select A or 
[B] B or neither. 


When several elements are stacked within braces the user 
must select one of these elements. 


{A} 
Example: {B} User must select A or B or C. 


{C} 
Lowercase italics denote a parameter which must be replaced 
by a user-supplied variable. 
Example: ADD sub-command 
Words in upper case appearing in syntax or format 
statements must be entered exactly as shown. 


Example: ADD 
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INTRODUCING 
DICTIONARY /3000 


OVERVIEW 


Dictionary/3000 is a Hewlett-Packard facility that provides a comprehensive 
set of software programs that allow you to: 


create any number of data dictionaries; 

create and maintain entries in the dictionary; 
create and maintain an IMAGE/3000 data base; 
create HP Inform/3000 groups. 


Data Dictionary/Directory 


Dictionary/3000 includes an easy-to-use, interactive program for the creation 
and maintenance of entries in a data dictionary. This program (called 
DICTDBM) provides you with a set of commands for the entry and maintenance of 
entries in a data dictionary. 


The data dictionary is more than just a dictionary. It is also a directory 
telling you where data is stored, who is responsible for the data, and much 
more. 


The entries in Dictionary/3000's data dictionary can define and describe an 
organization's structure, identify the data used by an organization, specify 
where the data is stored, identify what programs generate the data, and 
define and describe HP Inform/3000 groups to report the data. 


Thus, Dictionary/3000's data dictionary is a central repository for 
information about an organization and its data processing environment. 


IMAGE Data Bases 


Dictionary/3000 also includes a complete set of utility programs that allows 
you to create and maintain an IMAGE data base and to transfer the definition 
of an existing IMAGE data base into the Dictionary/3000 data dictionary. 


Dictionary/3000 utilities support all the functions of a data base 
administrator, such as loading and unloading IMAGE/3000 data bases and 
auditing of IMAGE/3000 data bases. 
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Features 


Following are the main features of Dictionary/3000: 


e An interactive program (DICTDBM) allows you to create and maintain entries 
in the data dictionary for: 


data 


IMAGE data bases 

MPE and KSAM files 

HP Inform/3000 groups 

physical locations 

organizational structures 
application programs 

security for data bases and files 
relationships between the entries 


e A comprehensive set of utilities: 


data 
data 
data 
data 
data 
data 


base 
base 
base 
base 
base 


creation program (DICTDBC) 
definition program (DICTDBD) 
audit program (DICTDBA) 
unload program (DICTDBU) 
load program (DICTDBL) 


dictionary cleanup program (DICTBDM,UTIL) 


Data Dictionary Entries 


The DICTDBM program includes commands that allow you to create and maintain 
entries in your data dictionary. After creating an entry, other commands 
allow you to establish and define relationships between entries. 


Through a combination of commands, you have complete control of the 
information in your data dictionary. Thus, you can create entries, delete 
entries, change entries, and so forth. 
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DATA DEFINITIONS 
Files: 
data + data relationships + security 
Groups: 
commands HP Inform/3000 groups 
Categories: 


organizational information 
Locations: 
catalog of system's account structures 
DICTDBM Procedures: 
directory of application programs 





Figure 1.1 Summary of Data Dictionary /Directory 


Data Base Creation 


Dictionary/3000 includes an interactive utility program, DICTDBC, that allows 
you to create an IMAGE data base from your data dictionary. The definition, 
association, and relationship entries for the data base must exist in your 
data dictionary prior to using this utility. 


Data Base Definition 
Dictionary/3000 includes an interactive utility program, DICTDBD, that allows 
you to transfer the definition of an existing IMAGE data base into your data 


dictionary. This utility creates the definition, association, and 
relationship entries for you. 


Data Base Audit 


Dictionary/3000 includes an interactive utility program, DICTDBA, that allows 
you to audit an IMAGE data base for synonym, chain, and linkage usages. 
Additional information, such as capacity usage, is also given. 


Data Base Unload 
Dictionary/3000 includes an interactive utility program, DICTDBU, that allows 


you to unload the data files of an IMAGE data base. Selective unloading is 
one of the main features of this utility. “ 
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Data Base Load 


Dictionary/3000 includes an interactive utility program, DICTDBL, that allows 
you to load data into IMAGE data base files. Selective loading and editing 
are two of the main features of this utility. 


DICTDBC 
DICTDBD 


Data 
Dictionary 


DICTDBA 


UTILITIES 





Figure 1.2 Summary of Utilities 


Data Dictionary Cleanup 


Dictionary/3000 includes a data dictionary utility program (DICTDBM,UTIL) 
that allows you to perform periodic maintenance. This process removes 
byproducts of DICTDBM processing that sometimes build up in a dictionary 
after extensive use of DICTDBM. 
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HOW TO USE THIS MANUAL 


This manual 
Section 


Section 
Section 
Section 


Section 


Appendix 
Appendix 
| Appendix 


Appendix 


Appendix 


Appendix 


is divided into the following sections: 


I 


IL 


IIL 


IV 


Introduces you to Dictionary/3000. 
Describes the concepts behind and the use of DICTDBM - a 
program designed to create and maintain entries in your 


data dictionary/directory. 


Provides an explanation of the commands used to create and 
maintain entries for various structures. 


Describes the commands used to create and maintain entries 
in your data dictionary/directory. 


Gives an overview of each utility, and describes how each 
is used. 


DICTDBM Error Messages. 
Dictionary/3000 Utility Error Messages. 
Initialization Procedures. 


Describes how HP Inform/3000 links files to generate 
reports. 


Glossary of Terms. 


DICTDBM Quick Reference. 










HOW TO RUN 
DICTIONARY /3000 


SECTION 


OVERVIEW 


Dictionary/3000 provides a Data Base Maintenance program (DICTDBM) to create 
and maintain entries in a data dictionary. This section describes how to run 
the program and use its HELP facility, describes the syntax for the commands 
in the program, defines the options that can be used with the commands, and 
lists all the commands and sub-commands available in the DICTDBM program. 


Running the DICTDBM Program 


To use the data dictionary, it must first be loaded and initialized onto your 
system by your system manager (see Appendix C). 


After logging on, you are ready to run the data dictionary program. DICTDBM 
assumes the dictionary exists in the PUB group of your log-on account. If 
the dictionary you wish to use exists in a different MPE group and/or 
account, you must first identify these by issuing a file equation before 
running DICTDBM. The file equation should be as follows: 

FILE DICT.PUB=DICT group.account 
Next, run the data dictionary program: 

RUN DICTDBM.PUB.SYS 
Then press the RETURN key. 
The data dictionary prompts you to enter a password as follows: 

PASSWORD FOR DICT .PUB> 
You will not see the password displayed as you enter it. You must enter the 
password exactly as it appears in the system - that is, all caps, all lower 


case, initial cap, or some combination of the three. The individual 
responsible for the data dictionary can give you the password information. 
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The data dictionary supports two types of field entry. One, "form entry", has 
entry fields in enhanced video. The other, "normal terminal display", uses a 
less-than sign (<) to delimit entry fields. Both types of field entry 
indicate the maximum number of characters you can enter. In this manual, all 
examples are shown in "normal terminal display". 


After the correct password is entered, the data dictionary lets you choose 
the type of field entry you wish to use with the following prompt: 


FORMS ENTRY(Y/N)?> 


A response of "Y" indicates that you want to use the enhanced video type of 
field entry. 


Whenever a choice between two options is given within parentheses, the first 
choice listed is the DEFAULT choice, unless otherwise specified; thus, just 
pressing RETURN is the same as entering that choice. 


After responding to the FORMS ENTRY prompt, the data dictionary issues a 
command prompt (>). You can use the commands available in the data dictionary 
to create, manipulate, or maintain entries. When you want to terminate 
execution of the data dictionary, enter the EXIT command in response to a 
command prompt. 


You add entries to the data dictionary through a series of command strings in 
response to a command prompt (>). The action of the command string can be 
modified or enhanced by including one or more of the available command 
options. 
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COMMAND SYNTAX 
A Dictionary/3000 command string has the following syntax: 


[option] command sub-command 


option is a list of one or more command options which enhance or 
modify the action of the command. For example, REPEAT, 
SORT, etc. (See Options Used With Commands, described 
next, for an explanation of each option. ) 


command specifies the command action. For example, ADD, RELATE, 
etc. . 
sub-command specifies the target of the command's action. For 


example, ELEMENT, GROUP, etc. 


For each command you must enter both the command and a sub-command, except 
for the EXIT command. Optionally, each command string can be preceded by one 
or more options. Only one command string is allowed for each command prompt. 


You may use the appropriate abbreviations for the commands and sub-commands. 
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OPTIONS USED WITH COMMANDS 


The following is a list of options which enhance or modify the action of the 
command. When used, they must come first in the command syntax and must be 
completely spelled out. 


PRINT directs the display to the line printer rather than to the 
user terminal. 


TPRINT formats the terminal display in line printer format. 
SORT sorts the display listing alphabetically before output. 
REPEAT repeats a command until the termination character (]) or the 


RETURN key is entered in response to a prompt. 


Multiple options, separated by commas, can be used in a single command 
string. 


When to Use the Options 


When you are displaying information, the PRINT option is useful. For 
example, use PRINT with the LIST, DISPLAY, or SHOW command. 


The TPRINT option is useful before directing output to the line printer. The 
listing will be displayed on your terminal in line printer format. Line 
printer format includes a banner line which shows the date and time of the 
report and where page breaks occur including page numbering. 


The SORT option is useful when you want an alphabetical listing from the LIST 
and SHOW commands. The REPORT command automatically displays the list in 
alphabetical order. 


When used, the REPEAT option causes the prompts for the command and/or 
sub-command to be repeated until terminated by the RETURN key or the 
termination character (]). One use for the REPEAT option is with the CREATE 
command when more than one data element is to be created. For instance, if 
you enter REPEAT CREATE ELEMENT, the prompt for ELEMENT is repeated allowing 
you to create many data elements without re-entering the command. The prompt 
for ELEMENT is repeated until you enter the terminating character. 
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SPECIAL CHARACTER OPTIONS 


The following characters have special meaning when used in response to a 
prompt: 


} in response to a prompt, terminates the prompting cycle within the 
command. It is equivalent to pressing RETURN to all subsequent 
prompts. 


] in response to a prompt, if the REPEAT option is used with the 
command, prompts for one level are terminated and reissued for the 
next level up; if the REPEAT option is not used, terminates the 
command. 


}] in response to a prompt, terminates the command. 
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COMMANDS AND SUB-COMMANDS 


The following is a list of commands and sub-commands, and their 
abbreviations, that can be used in the data dictionary. In Section IV, which 
describes the commands, each description includes a list of the sub-commands 
that can be used with that command (see Section IV). 


COMMAND ABBREVIATION SUB-COMMAND ABBREVIATION 


ADD CATEGORY 






























































CHANGE CHG CLASS CLS 

CREATE Cc CLASS-FILE CLF 

DELETE DEL ELEMENT E 

DISPLAY D FILE F 

EXIT E FILE-LOC FLC 
| HELP H GROUP G 

LIST ia LOCATION it 

MODIFY M PROCEDURE Pp 

PURGE P PROCEDURE-LOC PLC 

RELATE REL * 

REMOVE REM 

RENAME REN 

REORDER REO 

REPORT R 

RESEQUENCE RES 

SECURE SEC 

SHOW s 






UPDATE 






[ * The sub-commands for the HELP command are the command names. 


Note that each abbreviation is either a single or a three letter character 
string. 
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COMMAND USAGE CHART 


The following chart indicates the order in which the data dictionary commands 
can be used. The HELP command can be issued any time during a command 
sequence as long as the command prompt (>) appears. 


ew we ee eee 


| CREATE | 
| 
a 
/ | \ 
ra | 
Sons ms hei | sh abet Sal so ei cea: 
| ADD | | | RELATE | 
wieventies es ] a as ans eet inte nl ee 

| | | 

| | | 

| | | 

| | | 
| REPORT | | REPORT | | SHOW | 
| SHOW | | DISPLAY | | | 
| LIST | | 
| | | | | | 
| RESEQUENCE | | RENAME | | REORDER | 
| | | | | | 
| UPDATE | | MODIFY | | CHANGE | 
| | | | | | 
| DELETE | | PURGE | | REMOVE | 
| | | | | 
| SECURE | | | | | 


ee eee me ee ee ee 


The chart shows that entities must first be created in the dictionary through 
the CREATE command. Next, entities can be added to other entities through 
the ADD command, related to other entities through the RELATE command, or 
displayed or modified through the commands listed in the center box (REPORT, 
DISPLAY, LIST, RENAME, MODIFY, or PURGE). Following the ADD command, the 
REPORT, SHOW, RESEQUENCE, UPDATE, DELETE, or SECURE commands can be used. 
Following the RELATE command, the SHOW, REORDER, CHANGE, or REMOVE commands 
can be used. The EXIT command, not shown in the above chart, can be used at 
any time to exit the data dictionary program (DICTDBM). 
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Looking at the three large boxes shown in the chart, note that each 
horizontal row of commands are similar. For example, UPDATE, MODIFY, and 
CHANGE are similar. The difference between such commands is the command it 
follows: ADD, CREATE, or RELATE. 


The commands which follow the ADD command (REPORT, SHOW, RESEQUENCE, UPDATE, 
DELETE, and SECURE) can be used to display or modify entities which have been 
ADDed to other entities. For example, these commands can be used to display 
or modify an element which has been added to a file. Entities are always 
added to unlike entities - that is, an element is added to a file, but an 
element can not be added to another element. Hence, REPORT and SHOW can be 
used to display the association between unlike entities. Similarly, 
RESEQUENCE, UPDATE, DELETE, and SECURE are used to modify the association 
between unlike entities. 


Similarly, the commands which follow the RELATE command (SHOW, REORDER, 
CHANGE, and REMOVE) can be used to display or modify entities which have been 
RELATEd to other entities. Entities are always related to like entities - 
for example, a file can be related to another file, but an element can not be 
related to a file. Hence, SHOW can be used to display the relationship 
between like entities; REORDER, CHANGE, and REMOVE are used to modify the 
relationship between like entities. 


The commands which follow the CREATE command (REPORT, DISPLAY, LIST, RENAME, 
MODIFY, and PURGE) affect the entities themselves. They can be used to 
display or modify any entities which have been created - whether they have 
been added or related to other entities or not. 
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USING THE 
COMMANDS 


OVERVIEW 


The DICTDBM commands are used to create and maintain entries in your data 
dictionary. These entries can define and describe data elements and 
structures. Each entry in your data dictionary is unique. 


The following structures can be defined in your data dictionary: 


IMAGE data bases and security 

Other file structures (MPE, KSAM, and VPLUS) 
Application programs 

Physical locations 

Organizational structures 

HP Inform/3000 groups 


This section gives an overview of how to use the commands to create and 
maintain each structure. 


Using the Commands 


USING COMMANDS TO DEFINE A DATA BASE 


An IMAGE data base is defined in the data dictionary in two ways. If you 
have an existing IMAGE data base, you can use the Data Base Definition 
utility program (DICIDBD) to transfer the data base definitions from the data 
base root file to your data dictionary. A complete explanation of this 
utility can be found in Section V of this manual. 


The second way is to use the commands provided by the DICTDBM program. 


In the data dictionary, data sets used in a data base are considered files, 
and data items are considered data elements. Manual master sets are MAST 
files; automatic master sets are AUTO files; detail sets are DETL files. The 
data base is also considered a file within the dictionary - a BASE file. 


You complete the definition for a data base by establishing a relationship 
between the BASE file and the data sets. This relationship is a hierarchical 
relationship and is defined using the RELATE command. (Refer to Section IV of 
this manual for a description of this command.) This hierarchy is summarized 
in figure 3.1. 
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<---- PARENT file 


<---- CHILD files 


data data data 
elements eee element elements eee 





Figure 3.1 Summary of Hierarchical Structure for a Data Base 


The BASE file is the top of the structure and is the PARENT file. The data 
sets are related to the BASE file and are CHILD files. In this structure, the 
PARENT file cannot have data elements directly associated with it. 


The following description outlines the steps involved when you use the 
DICTDBM commands to define a data base. A complete description including 
examples for all the commands is given in Section Iv of this manual. 


Creating Elements and Files for a Data Base 


An element or a file must be defined in the data dictionary before you can 
associate or relate it to another entry. The CREATE command is used to 
define an entry for a data element or a file. 


Either the command string CREATE ELEMENT or CREATE FILE is used to create the 
entry in the data dictionary. The name for the element or the file must be 
unique. The REPEAT option can precede the command string allowing you to 


Using the Commands 


create definitions for more than one element or file without repeating the 
command yourself. An entry for the BASE file must be created to later 
establish the hierarchical relationship. 


In response to the RESPONSIBILITY prompt, you may include information about 
who is responsible for the integrity of the element or the file. Although not 
required, this is useful information for the individual responsible for the 
dictionary should a problem occur within the dictionary. 


If you are defining an IMAGE data base, the rules for defining a master data 
set and a detail data set apply. For example, if the data set is a detail 
set, you must indicate which data elements are the search items, the name of 
the master set each search item is related to, the data set's capacity and so 
forth. 


After creating entries, you can use either of two commands to display the 
entry: LIST or DISPLAY. If you want to delete the entry, use the PURGE 
command. If you want to change the entry, the MODIFY comand or the RENAME 
command can be used. 


The RELATE ELEMENT command string can be used to define CHILD elements 
(fields) within a PARENT data element. This allows access to parts of a 
larger data element. For example, in the case of an IMAGE data base which 
contains a compound data item, CHILD elements can be used to provide access 
to the sub-items of the compound item; in response to the BYTE POSITION 
prompt, specify the starting location of the sub-item within the compound 
item. 


Relating Data Sets to a BASE File 


The hierarchical relationship between the data sets and the BASE file is 
established with the RELATE command. The command string RELATE FILE is used 
to define this relationship. This command allows for more than one data set 
to be related to a BASE file during the command cycle. If relationships for 
more than one data base are to be established, use the REPEAT option with the 
command string. 


Relationship entries can be displayed by using the SHOW command. All the 
data sets and, optionally, all the data elements associated with the set, are 
displayed for a BASE file. For a data set, the elements directly associated 
with it are displayed. The elements are displayed in the physical order of 
their association with the file. The SHOW command indicates key elements 
with an asterisk, identifies the chain paths, and much more. The REPORT 
command displays an alphabetical list of the elements associated with a data 
set, or an alphabetized schema-type listing of elements for a data base file. 


- You can delete the relationship entry with the REMOVE command and change the 
entry with the CHANGE command. The REORDER command is used to change the 
physical order in which the files are related to the BASE file. 
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Adding Data Elements to Data Sets 


The ADD command is used to add data elements to data sets. You use the . 
command string ADD FILE to define this association. An entry is defined that 
associates an element with a data set. 


The dictionary prevents you from associating elements directly with the BASE 
file by issuing an error message and by reissuing the prompt for FILE. 


To display the association entries, either the REPORT or SHOW command is 
used. The SHOW command uses an asterisk to indicate which element is the key 
element in the file, and displays the elements in the order in which they are 
associated with the file. 


The association entry is deleted using the DELETE command and is changed 
using the UPDATE command. To change the physical order in which the elements 
are associated to the data set, use the RESEQUENCE command. 


Securing a Data Base 


Since your data base definition is for an IMAGE data base, the definition of 
security is for an IMAGE data base. IMAGE allows the data base designer to 
control access to specific data sets and data items by defining up to 63 user 
classes. The classes are associated with data sets and data items in read 
or write class lists. This association determines which user classes may 
access which data elements and the type of access that is granted. For a 
complete description of how to protect an IMAGE data base, see the IMAGE/3000 
Reference Manual. 


In the data dictionary, user security classes are identified by an integer 
from 0 through 9999 and are associated with a password defined by the data 
base designer. Each security class number is unique and can be created only 
once. 


when the Dictionary/3000 Data Base Creation utility program (DICTDBC) is used 
to create the data base, the security class numbers are reassigned by the 
utility to conform to the numbering scheme used in IMAGE. 


The CREATE command is used to define the entry for a user security class. You 
use the command string CREATE CLASS for this entry. During the command cycle, 
a prompt is issued that allows you to restrict the use of the class toa 
particular data base, that is, limit the scope of the class to a data base 
when elements may appear in more than one data base. 


After creating user security classes, either the LIST or DISPLAY command can 
be used to display the entry. If you want to delete an entry from the 
dictionary, you use the PURGE command. To change the entry, you use either 
the MODIFY command or the RENAME command. 
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The association between the security classes and the data sets or the 
elements is established using either the SECURE or ADD command. The SECURE 
FILE and ADD CLASS command strings allow you to specify protection at the 
element level, while ADD CLASS-FILE specifies protection at the file level. 


SECURE FILE is used to specify protection that applies to all the data 
elements in the file. In this way, it is similar to using repeated ADD CLASS 
command strings. A major difference between SECURE FILE and ADD CLASS-FILE 
is that with the SECURE command only files which are IMAGE files can be used, 
while ADD CLASS-FILE can be used to specify security for a data set, for an 
MPE file, for a KSAM file, and for a VPLUS forms file. Security for MPE, 
KSAM, and VPLUS files is the "lockword" required to access the file. 


Creating A Data Base 


You can use the Data Base Creation utility program (DICTDBC) to create a 
schema file and a root file from the definition in the dictionary. See 
Section V of this manual for a detailed description of this utility. 
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USING COMMANDS TO DEFINE OTHER FILE STRUCTURES 


You can use the data dictionary to define MPE files, KSAM files, and VPLUS 
forms files, including the forms contained in the forms file. Dictionary/3000 
does not provide utilities to build these file structures as it does for 
IMAGE data base files. You must build them external to the dictionary in the 
usual manner. 


For MPE and KSAM files, you define the record layout for the file. In the 

dictionary, each field in the record is a data element with characteristics 
such as type, size, and so forth. For the VPLUS forms file, you define each 
form as a file, and the fields within each form as data elements. 


You complete the definition for a VPLUS forms file by establishing a 
relationship between the VPLUS forms file and each form within the VPLUS 
file. This relationship is a hierarchical relationship and is established 
using the RELATE command. (Refer to Section IV of this manual for a 
description of this command.) This hierarchical relationship is summarized in 
figure 3.2. 


<———- PARENT file 


«<—— CHILD files 


data data 
elements eee elements eee 





Figure 3.2 Summary of Hierarchical Structure for a VPLUS Form File 
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The VPLUS forms file is the top of the structure and is the PARENT file. Each 
FORM file is related to the VPLUS file and is considered a CHILD file. In 
this structure, the PARENT file cannot have data elements directly associated 
with it.. 


The following description outlines the steps involved when you use the 
DICTDBM commands to define other file structures. A complete description 
including examples for all the commands is given in Section IV of this 
manual. 


Creating Elements and Files for 
MPE, KSAM, and VPLUS Files 


Creating files and data elements for these structures is similar to creating 
them for a data base. An element or a file must be defined in your dictionary 
before you can associate or relate it to another entry. To define the 
entries, you use the command string CREATE ELEMENT or CREATE FILE. The name 
you use for the element or the file must be unique. The REPEAT option can 
precede the command string allowing you to create entries for many elements 
or files without re-entering the command yourself. A definition for the 
VPLUS forms file must be created to later establish the hierarchical 
relationship. 


In response to the RESPONSIBILITY prompt, you may include information about 
who is responsible for the integrity of the data element or file. Although 
not required, this is useful information for the individual responsible for 
the dictionary should a problem occur within the dictionary. 


After creating entries, you can use either of two commands to display the 
entry: LIST or DISPLAY. Entries can be deleted by using the PURGE command, 
and be changed by using the MODIFY or RENAME command. The RELATE ELEMENT 
command string can be used to define CHILD elements (fields) within a PARENT 
data element; this allows access to parts of a larger data element. 


Adding Data Elements to Files 


The ADD command is used to associate data elements to files. You use the 
command string ADD FILE to define this association. An entry is defined that 
associates an element with a file. 


The dictionary prevents you from associating elements directly with the VPLUS 
file by issuing an error message and reissuing the prompt for FILE. 


You must associate elements with the file according to the record layout or 
form design. When elements are associated with a KSAM file, a prompt is 
issued for you to identify which element or elements are keys for the file. 
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To display an alphabetized listing of association entries, you use the REPORT 
command. For a form, the list is of elements associated with the form, while 
for a VPLUS file, the list is of all elements associated with CHILD files. 
The SHOW command is used to display each file and the elements associated 
with it, or a complete listing of the forms in a VPLUS file, and optionally, 
the elements within each form. The forms are displayed in the physical order 
of their relationship to the VPLUS file, and the elements are in the physical 
order of their association with the form. For KSAM files, the SHOW command 
indicates key elements with an asterisk, "*". 


You delete an association entry by using the DELETE command or change the 
entry by using the UPDATE command. If you want to change the physical order 
in which the association entries were made, use the RESEQUENCE command. 


Relating Form files to a VPLUS File 


The hierarchical relationship between forms and a VPLUS forms file is 
established using the RELATE command. The command string RELATE FILE is used 
to define this relationship. This command allows more than one form to be 
related to the VPLUS file during the command cycle. 


You display the entries by using the SHOW command or the REPORT command. 


The relationship entry is deleted by using the REMOVE command and is changed 
by using the CHANGE command. You can use the REORDER command to change the 
physical order in which the CHILD files are related to the PARENT file. 


Security for MPE, KSAM, and VPLUS Files 


Security as defined and used for IMAGE data bases is not applicable to MPE 
files, KSAM files, and VPLUS forms files. For these files "lockwords" are 
used for protection. 


The CREATE command is used to define a security class for the lockword. In 
the dictionary, the lockword to the file is called the PASSWORD. 


After you create a class for the lockword, the ADD CLASS-FILE command string 
is used to associate the security class with the file. 


To display the security class entries, you can use either the LIST or 
DISPLAY command. If you want to delete an entry from the dictionary, use the 
PURGE command. To change the entry, the MODIFY command or the RENAME command 
is used. 
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Creating Other File Structures 


Dictionary/3000 provides the Data Base Creation utility program to create an 
IMAGE data base in the dictionary; however, special utilities are not 
provided to build any other file structures (MPE, VPLUS, or KSAM). These 
must be defined in the dictionary in the usual manner. 
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USING COMMANDS TO DEFINE PROCEDURES 


You can use your data dictionary to capture the data processing environment 
for your company by defining in the dictionary all the application programs, 
the routines, the sub-routines, and the variables used in the environment. 
The dictionary uses PROCEDURE to document this information. 


Each program, routine, or sub-routine is a procedure in the dictionary. The 
variables used by each are data elements with characteristics such as type, 
size, and so forth. 


You can completely describe a program and its routines or sub-routines by 
defining a hierarchical relationship between them. The RELATE command is 
used to establish this hierarchical relationship. (Refer to Section IV of 
this manual for a description of this command.) The hierarchical relationship 
for procedures is summarized in figure 3.3. 
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Figure 3.3 Summary of Hierarchical Structure for a Procedure 


The procedure that uses or calls other procedures is the top of the structure 
and is a PARENT procedure. The routines and/or sub-routines used or called 
by the PARENT procedure are CHILD procedures. A CHILD procedure can in turn 
be a PARENT because it may use or call other routines or sub-routines. This 
hierarchical structure allows data elements to be associated with a procedure 
regardless of its level in the structure. 
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Note that Dictionary/3000 will not allow you to document recursive 
procedures. That is, if a procedure has been documented as a CHILD of 
another procedure, Dictionary/3000 will not allow you to specify that other 
procedure as a CHILD of the first one. 


The following description outlines the steps involved when you use the 
DICTDBM commands to define procedures. A complete description including 
examples for all the commands is given in Section IV of this manual. 


Creating Data Elements and Procedures 


The method for creating procedures and data elements is similar to creating 
files and data elements for a data base. To define them, use the command 
string CREATE PROCEDURE or CREATE ELEMENT. An element or a procedure must be 
defined in your dictionary before you can associate it with or relate it to 
another entry. The name you use for the procedure or the element must be 
unique. The REPEAT option can precede the command string allowing you to 
create definitions for more than one procedure or element without re-entering 
the command yourself. 


In response to the RESPONSIBILITY prompt, you may include information about 
who is responsible for the integrity of the procedure or element. Although 
not required, this is useful information for the individual responsible for 
the dictionary should a problem occur within the dictionary. 


After creating entries, either of two commands can be used to display the 
entries: LIST or DISPLAY. If you want to delete an entry, you use the PURGE 
command. To change an entry, you can use either the MODIFY command or the 
RENAME command. 


Relating Procedures to a Procedure 


The hierarchical relationship between procedures is established using the 
RELATE command. You use the command string RELATE PROCEDURE to define this 
relationship. This command allows more than one CHILD procedure to be related 
to a PARENT procedure during the command cycle. If relationships are to be 
established for more than one PARENT procedure, you can use the REPEAT option 
with the command string. 


Relationship entries can be displayed by using the SHOW command. For a PARENT 
procedure, the SHOW command displays the data elements associated with it, 
the CHILD procedures related with it, and optionally, the data elements 
associated with each CHILD. For a CHILD procedure, the data elements 
associated with it are displayed. The elements are displayed in the physical 
order of their association with the procedure, and the CHILD procedures are 
displayed in the physical order they were related to the PARENT procedure. 
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The REPORT command can be used to display an alphabetized list of the 
_elements used by a procedure or, if a PARENT procedure, used by the CHILD 
procedures plus itself. 


You can delete the relationship entry by using the REMOVE command and change 
the entry by using the CHANGE command. The REORDER command is used to change 
the physical order in which the CHILD procedures are related to the PARENT 
procedure. 


Adding Data Elements to Procedures 


The ADD command is used to associate data elements with a procedure. You use 
the command string ADD PROCEDURE to define the association. An entry is 
defined that associates the element with the procedure. 


To display the entries either the REPORT command or the SHOW command can be 
used. 


You can delete an association entry by using the DELETE command or change the 
entry by using the UPDATE command. If you want to change the physical order 
in which the associated entries were made, you use the RESEQUENCE command. 
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USING COMMANDS TO DEFINE LOCATIONS 


You can also use your data dictionary to document the physical locations 
where procedures and files are used. In the dictionary you use LOCATION to 
capture this information. The specific MPE group and account, and the machine 
on which the procedure or data file is used can be identified. This 
information is helpful when a change to a procedure or file occurs because it 
tells you where the procedure or data file resides. 


Hierarchical structures for locations cannot be defined in your dictionary. 


The following description outlines the steps involved when you use the 
DICTDBM commands to define locations. A complete description including 
examples for all the commands is given in Section IV of this manual. 


Creating Locations 


You use the CREATE LOCATION command string to define an entry for a location. 
The name you use for the location must be unique. The REPEAT option can 
precede the command string, allowing you to create definitions for more than 
one location without re-entering the command yourself. 


Information identifying the MPE group, account, and machine is not required 
for the entry. However, when changes are made to the files and procedures, 
you can save time and effort by knowing where updates need to occur. 


After creating entries, you can use the LIST or DISPLAY commands to display 
the entry. If you want to delete an entry, you use the PURGE command. To 
make changes to the entry, you can use either the MODIFY command or the 
RENAME command. 


Adding Files and Procedures to Locations 


Before a file or procedure can be associated with a location, it must be 
defined in the dictionary. 


The method for associating files and procedures with a location differs 
slightly from previous methods. You use the ADD command to define the 
association, but the command string is ADD FILE-LOC or ADD PROCEDURE-LOC. An 
entry is defined that associates the file or procedure with the location. 


To display the association entries, the command strings DISPLAY LOCATION or 
SHOW LOCATION are used. An association entry is deleted by using the command 
strings DELETE FILE-LOC or DELETE PROCEDURE-LOC. 
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USING COMMANDS TO DEFINE CATEGORIES 


Your data dictionary provides a way for you to identify functional areas in 
your business and to show how information flows from area to area. The 
dictionary uses CATEGORY to define this information. 


Each functional area is a category in the dictionary. The information may 
consist of departments, people, functions, documents, and so forth. 


The organizational flow chart for the functional area can be documented by. 
defining a hierarchical relationship between them. This relationship is 
established by using the RELATE command. (Refer to Section IV of this manual 
for a description of this command.) This hierarchical relationship is 
summarized in figure 3.4. 
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Figure 3.4 Summary of Hierarchical Structure for a Category 
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A category is at the top of the structure and is a PARENT category. Other 
categories are related to the top category and are CHILD categories. A CHILD 
category can in turn be a PARENT category to other CHILD categories. In this 
hierarchical structure, a PARENT category cannot have data elements 
associated with it. 


The following description outlines the steps involved when you use the 
DICTDBM commands to define categories. A complete description including 
examples for all the commands is given in Section IV of this manual. 


Creating Elements and Categories 


To create data element and category entries, you use the CREATE command. You 
use the command string CREATE ELEMENT or CREATE CATEGORY to define the entry. 
An element or a category must be defined in your dictionary before you can 
associate or relate it to other entries. The name you use for the category or 
the element must be unique. 


In response to the responsibility prompt, you may include information about 
who is responsible for the integrity of the category or element. Although 
not required, this is useful information for the individual responsible for 
the dictionary should a problem occur within the dictionary. 


The created entries can be displayed using the LIST or DISPLAY commands. You 
can make changes to the entry by using the MODIFY command, and rename the 
entity by using the RENAME command. If you want to delete the entry, you use 
the PURGE command. . 


Relating Categories to a Category 


The hierarchical relationship between categories is established with the 
RELATE command. You use the command string RELATE CATEGORY to define this 
relationship. This command allows more than one category to be related to the 
PARENT category during the command cycle. 


To display the relationships, you can use the SHOW command. For a PARENT 
category, this command displays each CHILD category, and optionally, the data 
elements associated with the CHILD. For a CHILD category, the data elements 
associated with it are displayed. The elements are displayed in the physical 
order they were associated with the category, and the CHILD categories are 
displayed in the physical order they were related to the PARENT category. 


The REPORT command can be used to display an alphabetical listing of the 


elements associated with a category or, for a PARENT category, all the 
elements associated with the CHILD categories. 
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The relationship entry is deleted by using the REMOVE command, and is changed 
by using the CHANGE command. You can use the REORDER command to change the 
physical order in which the CHILD categories are related to the PARENT 
category. . 


Adding Elements to Categories 


The ADD command is used to associate data elements to categories. You use 
the command string ADD CATEGORY to define this association. An entry is 
defined that associates an element with a category. 


The dictionary prevents you from associating elements to a PARENT category by 
issuing an error message and reissuing the prompt for CATEGORY. 


To display association entries, either the REPORT command or the SHOW command 
can be used. If you want to delete the association entry, you use the DELETE 

command. To change the entry, you use the UPDATE command. The physical order 

of the association is changed by using the RESEQUENCE command. 
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USING COMMANDS TO DEFINE HP INFORM/3000 GROUPS 


Your data dictionary must be properly set up in order to produce the desired 
reports using HP Inform/3000. Usually this is the responsibility of the Data 
Base Administrator (DBA). HP Inform/3000 enables the user to define and 
create reports from data contained in IMAGE data bases, MPE files, and KSAM 
files. (For specific information on how to run HP Inform/3000 and produce 
reports, see the HP Inform/3000 User's Guide, part number 32246-90001. ) 


HP Inform/3000 makes the distinction between two methods of organizing data: 
data bases and HP Inform/3000 groups. In order for a user to define a 
report, HP Inform/3000 presents a Data Organization Menu from which one of 
these two methods must be selected. Which method is appropriate depends on 
whether the data elements can all be found in one data set, or whether they 
have been organized into groups. 


HP Inform/3000 Groups 


HP Inform/3000 groups are logical groupings of data elements which have been 
defined in the data dictionary. Before defining HP Inform/3000 groups, the 
DBA needs to gather and organize all the information required by all the HP 
Inform/3000 users. For example, some users will want to produce marketing 
reports, some manufacturing reports, others personnel reports, etc. The 
groups can be defined according to these identified categories of information 
which have logically connected data elements - "data names" as they are 
called in HP Inform/3000. 


By organizing data elements into groups, the DBA is taking advantage of HP 
Inform/3000's ability to access elements from multiple and different types of 
data files. Elements can be accessed from more than one data set. KSAM and 
MPE files can also be accessed. In addition, an element can be assigned an 
alias name which is especially meaningful to the HP Inform/3000 user. This 
name will then appear on HP Inform/3000's Data Names Menu. 


You establish a hierarchical relationship between groups by using the RELATE 
command (refer to Section IV of this manual for a description of this 
command). This relationship is summarized in figure 3.5. It is reflected in 
the hierarchy of HP Inform/3000 Group Menus and Subgroup Menus - seen by the 
HP Inform/3000 user. 
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Figure 3.5 Summary of Hierarchical Structure for Groups 


SMENU is the top of the structure and is the PARENT group. Other groups are 
related to $MENU and are CHILD groups. A CHILD group can in turn be a PARENT 
group of other CHILD groups (which are called "subgroups" in HP Inform/3000 
and appear on HP Inform/3000's Subgroup Menu). This hierarchical 
relationship can exist up to 10 levels deep, starting with $MENU. A PARENT 
group cannot have data elements associated with it. Note that $MENU is 
created automatically when the data dictionary is initialized and cannot be 
altered or purged. 


Each group in this hierarchy must be defined in the data dictionary. The 
data elements you wish to associate with a group and the files those data 
elements are associated with must first be defined in the data dictionary. 
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Preceding topics in this section provide the details for defining data bases 
and other file structures. The following description outlines the steps 
involved when you use the DICTDBM commands to define groups. A complete 
description for all the commands is given in Section Iv of this manual. 


Creating Elements and Groups 


To create data elements and group entries, you use the CREATE command. The 
CREATE ELEMENT or CREATE GROUP command string is used to define the entry. 

An element or group must be defined in your dictionary before you can 
associate or relate it to other entries. The name entered for the element or 
group must be unique among elements and groups, respectively. 


The remaining prompts allow the user to provide useful information, but are 
not required. You can create many elements or groups in a command cycle by 
using the REPEAT option. 


After creating entries in the data dictionary, you can use the LIST or 
DISPLAY commands. If you want to delete an entry, use the PURGE command. To 
change an entry, use either the MODIFY or RENAME commands. 


The RELATE ELEMENT command string can be used to define CHILD elements 
(fields) within a PARENT data element. Note, however, that to report ona 
CHILD data element from HP Inform/3000, that data element must have been 
added to the group (the PARENT element may or may not be in the group). 


Relating Groups to a Group 


The hierarchical relationship between groups is established with the RELATE 
command. You use the command string RELATE GROUP to define this 
relationship. When relating groups to the top of the hierarchical structure, 
enter $MENU in response to the prompt for PARENT GROUP; in response to CHILD 
GROUP, enter the name of the group to be related to $MENU. The groups 
related to $MENU will all appear on HP Inform/3000's Group Menu. 


A relationship for other levels is defined in a similar manner - by entering 
the name of the higher level group for PARENT GROUP, and the lower level 
group for CHILD GROUP. If the PARENT group is not SMENU, the CHILD groups 
related to that PARENT group will appear on an HP Inform/3000 Subgroup Menu. 


The DESCRIPTION prompt allows you to supply useful information but is not 
required to define the relationship. 


The relationship between groups can be displayed by using the SHOW command. 
For a PARENT group, this command displays each CHILD group, if any, and the 
data elements associated with each CHILD. For a CHILD group, the data 
elements associated with it are displayed. The elements are displayed in the 
actual order they were associated with the group. 


sek 
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The REPORT command can be used to display an alphabetical listing of the 
elements associated with a group or with related CHILD groups. 


You can delete the relationship entry by using the REMOVE command and can 
change the entry by using the CHANGE command. The REORDER command is used to 


change the actual order in which the CHILD groups are related to the PARENT 
groups. 


EXAMPLE: 


>RELATE GROUP 


PARENT GROUP> $menu < 
CHILD GROUP> marketing < 
DESCRIPTION> 
CHILD GROUP> shipping < 
DESCRIPTION> 
CHILD GROUP> personnel < 
DESCRIPTION> 
CHILD GROUP> j < 
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The ADD GROUP command string associates data elements with previously created 
groups. The data element must already exist in the data dictionary. The 
dictionary will prevent you from associating elements with a PARENT group by 
issuing an error message and reissuing the prompt for GROUP. (Note that an 
element need not be associated with a file at the time the ADD GROUP command 
string is executed; however, the element must have been added to a file 
before HP Inform/3000 is executed. ) 


In response to the prompt for ELEMENT, enter the name of the data element. 
Responding to the ELEMENT ALIAS prompt is optional. HP Inform/3000 uses the 
element alias name in its Data Names Menu; if no element alias is given, the 
data element name (primary name) is used. Note that this element alias name 
should be meaningful to the HP Inform/3000 user since it will appear on HP 
Inform/3000's Data Names Menu. It or may not be the same as the element 
alias name specified when the element is added to a file. 


NOTE: The element alias name is only used by HP Inform/3000 on its Data 
Names Menu. The data element name (primary name) will be used as 
the report heading for that element unless a heading has been 
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specified in response to the HEADING TEXT prompt of the CREATE 
ELEMENT command string. In addition, the data element name 
(primary name) will be used in HP Inform/3000's "SELECTION 
CRITERIA FOR data name(s)" prompt unless you have responded to 
the ENTRY TEXT prompt of the CREATE ELEMENT command string. If 
you wish these to match the element alias name, you must specify 
the element alias name as the HEADING TEXT and the ENTRY TEXT on 
the CREATE ELEMENT command string. 


The prompt for FILE allows you to designate the name of the specific file 
which should be used to retrieve the values of that element when a report is 
being created from this group. For example, the data element "date" may be 
the date a product was purchased in one file, while it may be the date the 
product was shipped in another file; thus it is important to specify which 
file you want the values for "date" to be taken from. This would apply even 
if the data element "date" had been given different alias names when it was 
added to the different files. (This particular situation could be avoided if 
two separate data elements, such as "pur-date" and "“ship-date", are created 
in the dictionary and are each added to the appropriate file.) Note that 
when a file name is specified in response to the FILE prompt, the element 
must already be associated with that file. 


If, on the other hand, it is not important which file is used (for example, 
suppose the data element "soc-sec-no" existed in more than one file), itis 
better not to respond to the FILE prompt; HP Inform/3000 will have a higher 
probability of retrieving the values in an efficient manner. 


If a file specified in response to FILE is an IMAGE data set with more than 
one PARENT file (BASE), the prompt PARENT FILE is issued next and must be 
answered. 


The next prompt, VALUE AS A LINK, can be used to specify which elements 
should preferably be selected to link the desired elements into a logical 
record for reporting: 


(1) If each of the elements being associated with a group can link all the 
files, do not respond to the VALUE AS A LINK prompt for any of them. 


(2) If only one of the elements can link all the files, then give it a high 
priority link value (1) and let the link values of the others default 


(0). 


(3) If more than one element is needed to link the files, give a link value 
of 1 to the one that should be tried first, 2 to the one that should be 
tried next, and so on; use -1 if you never want the element to be used 
as a link and O (the default) if the element could be used if needed. 


NOTE: An element can link two files only if it exists in both files and 
if certain additional requirements, depending on the file being 
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linked to, are met. See Appendix D, How HP Inform/3000 Links 
Files to Generate Reports, for more information on linking. 


Elements. assigned a positive link value form a prioritized list to be used 
when it is necessary to link files. The lower the positive integer assigned 
to an element, the higher the likelihood that it will be used as a link. In 
general, you should assign a link value of 1 to the element that will link 
the most files containing elements for the group, 2 to the element that will 
link the next most, and so on. This will ensure that the reports an HP 
Inform/3000 user requests from a particular group will be generated 
efficiently. 


The following table summarizes the priorities of the possible link values: 


LINK VALUE PRIORITY 

1 Highest priority. 

2 Next highest priority after link value 
of 1. 

3 Next highest priority after link values 
1 and 2. 

n Next highest priority after link values 
1 7) 2 ? eos DO 1 ° 

0 Lowest priority. 

=. Never used as a link. 


Note that if an element has different meanings in different files (for 
example, the data element "date" may have different meanings in different 
files), you will not want it to be used as a link even if it links all the 
files containing elements for the group; give such a data element ("date") a 
link value of -l. (Note that in this case, simply answering the FILE prompt, 
without specifying a link value of -1, will cause the correct values for 
"date" to be printed in the report but will not help to link the files 
correctly. ) 
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By both responding to the FILE prompt for an element and assigning a positive 
link value to the element, you are designating a potential "driving file". 
The driving file is the file that is accessed first. Since at least one line 
of the report will be generated for each record retrieved from the driving 
file, the contents of a report could be quite different if the driving file 
is different. By designating a potential driving file, you are specifying 
that that file should be accessed first whenever: 


(1) any element from the group which exists in that file is requested for 
the report, and 


(2) no other potential driving file has been designated which 
(a) has a higher priority link value specified and 
(b) contains an element requested for the report. 


Hence, if you respond to the FILE prompt and designate a link value of 1 for 
a particular element, the specified file will be accessed first whenever any 
element which exists in that file is requested in a report; if you respond to 
the FILE prompt and designate a link value of 2 for another element, the file 
specified in response to this FILE prompt will be accessed first whenever any 
element which exists in that file is requested in a report and no element 
which exists in the first file is requested; and so on. 


NOTE: The linking process determines whether it is possible to generate 
the requested report and, if so, what specific data will be 
printed in the report. For more information about linking, link 
values, and driving files, see Appendix D of this manual, How HP 
Inform/3000 Links Files to Generate Reports. 


The DISPLAY ELEMENT ON MENU prompt allows the user to determine whether an 
element is to be displayed on HP Inform/3000's Data Names Menu and used when 
generating reports. By not displaying an element on the menu, you can 
include an element in the group for linking and not allow it to be used for 
reporting. 


Note that a CHILD data element can not be used in linking files. CHILD 
elements can, however, be requested in an HP Inform/3000 report as long as 
they have been added to the group; the PARENT element alone in the group is 
not sufficient. If a data element which is a CHILD is needed for a report, 
HP Inform/3000 will try to find the PARENT element. Since a CHILD element 
could have more than one PARENT, it will first use a PARENT that has been 
added to the group. If no PARENT of the CHILD element exists in the group, 
HP Inform/3000 tries to find any PARENT of the CHILD element it can find. In 
order to ensure that the correct CHILD element is retrieved, you should add 
the PARENT element to the group (in addition to the CHILD element); if you do 
not wish users to report on the PARENT element, add it to the group and 
respond "NO" to the DISPLAY ELEMENT ON MENU prompt. (You may also wish to 
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specify a link value of -1, if you do not want the PARENT element to be used 
to link files.) HP Inform/3000 retrieves the value of the entire PARENT 
element, but only displays the value of the appropriate CHILD element in the 
report. 


You can display association entries by using the REPORT or SHOW commands. To 
delete the association, use the DELETE command and to change it use the 
UPDATE command. The order in which the elements are associated with the 
group are the order they will appear on HP Inform/3000's Data Names Menu; 
this can be changed by using the RESEQUENCE command. 


EXAMPLE: 
>»ADD GROUP 
GROUP> marketing < 
ELEMENT> name < 
ELEMENT ALIAS> employee name < 
FILE> ! < 
ELEMENT> date < 
ELEMENT ALIAS> date of hire < 
FILE> empfile < 
VALUE AS A LINK> < 
DISPLAY ELEMENT ON MENU (Y/N)?n 
DESCRIPTION> 
ELEMENT > < 
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USING SELECTION CRITERIA WITH THE 
DISPLAY AND THE LIST COMMANDS 


When using the DISPLAY or the LIST command string, you can dictate the 
listing you want to see by entering one of the Selection Criteria values in 
response to a prompt. You can choose a listing based on character values, 
numeric values, or an expression of these values. In all cases, the type of 
listing is based on the sub-command used. 


You can enter a string of characters with a caret character (*) at the end, 
beginning, or in the middle of the string. Depending on where used, the 


caret has the following meaning: 


e If used at the beginning of a string, it means that all values ending 
with the string are to be listed. 


e If used at the end of a string, it means that all values beginning with 
the string are to be listed. 


e If two carets are used at the end of a string, it means that all values 
containing the string are to be listed. 


e If embedded between characters in a string, it means that values that 
match wherever characters appear in the string are to be listed. 


You can also enter an expression of these values using the following format: 
[relationship] value connector [relationship] value ... 
where: 


relationship is an optional field that can contain one of the following 
two letter codes: 


NE which means "not equal to" 

LT which means "less than" 

LE which means "less than or equal to" 

GT which means "greater than" 
_ GE which means "greater than or equal to" 


If a relationship is omitted, the default "equal to" is used. 


connector is the Boolean connection between the values. The following 
terms can be used: 
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TO the selected field must contain one of a range of values where 
the low end of the range precedes this connector and the high 
end of the range follows this connector. 


AND the selected field must contain both the value preceding and 
the value following this connector. 


OR the selected field must contain one or both of the values. 


The order of precedence is TO, then AND, then OR. 


If the value to be selected contains one or more blanks, then the value must 
be enclosed in quotation marks as follows. 


If you need more than one line for a selection expression, end the first line 
with a connector, and another selection line prompt is issued. 


EXAMPLES: 


Using carets and connectors: 


PROD* and “NO 


ACCT*® or PROD* and “NO 


CUST*~ and “NAME or ACCT* and “NO 


PROD* or ACCT* or CUST* 
"PROD NO" 


Using relationship operators: 


LT B 


GE R and LT V 


Values that begin with PROD and end 
with NO are selected. 


Values that begin with ACCT or values 
that begin with PROD and end with NO 
are selected. 


Values that begin with CUST and end 
with NAME, or values that begin with 
ACCT and end with NO are selected. 


Values that begin with PROD or ACCT or 
CUST are selected. 


Values that equal PROD NO are selected. 


Values which are less than values 
beginning with B are selected. 


Values which are greater than or equal 
to values beginning with R, and values 
which are less than values beginning 
with V are selected. 
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GE M or I* or LTC Values which are greater than or equal 
to values beginning with M, or values 
which are equal to values beginning 
with I, or values which are less than 
values beginning with C are selected. 
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USING EDIT DESCRIPTION COMMANDS 


Three commands allow text editing of a description: MODIFY, CHANGE, and 
UPDATE. The MODIFY command allows you to alter a description of an entity you 
entered with the CREATE command; the CHANGE command allows you to alter a 
description you entered with the RELATE command; the UPDATE command allows 
you to alter a description you entered with the ADD command. 


You indicate that you want to edit a description by responding with a "Y" or 
RETURN to the EDIT DESCRIPTION prompt. The description is edited by entering 
one of the following EDIT commands: 


LIST or L list one or more description lines 
ADD or A add description line or lines 
DELETE or D delete description line or lines 
REPLACE or R replace a description line 


RENUMBER or REN renumber description lines 


HELP or H displays available EDIT commands 
EXIT or E exit EDIT command 
EXAMPLE: 


>MODIFY CATEGORY 
CATEGORY> FINANCE < 
EDIT DESCRIPTION(Y/N)?> 


EDIT COMMAND>> ADD EDIT command ADD used. 
LINE NUMBER> 2 < line number to be added. 

2.000 > This category identifies the finance < 

3.000 > department for the Supplies Division. < 

4.000 > < 
RETURN ends the adding 

of lines. 

EDIT COMMAND>> EXIT EXIT to terminate EDIT. 


EDIT ATTRIBUTES(Y/N)? N 


> RETURN to command prompt. 
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USING EDIT MASKS 


You can define the output format for data elements in reports generated by HP 
Inform/3000, Report/3000, and Transact/3000. You do this by defining an edit 
mask for a data element to be formatted in a report. 


An edit mask is a string of characters describing how the data element should 
look when it appears in a report. Characters such as dollar signs and 
decimal points can be inserted, and leading zeros suppressed before the data 
element is displayed in reports. 


You can define edit masks with either the CREATE or MODIFY commands. 


Edit masks can be defined with up to 30 characters. All characters, except 
the following list, are treated as insert characters: 

Oi means that the next character in the source field is to be inserted 
into the display field. 


Zz means that leading zeros are to be suppressed. 


$ means that leading zeros are to be suppressed and that the left-most 
zero is to be replaced with a dollar sign. 


by means that asterisks are to replace leading zeros. 


means that the implied decimal point defined for the element is to be 
aligned in the position where this one appears. 


: means that a decimal point for a data element is to appear in the 
position specified by "!"; use of the "!" character overrides an 
implied decimal point for the data element. 


If the last character of the edit string is a negative sign, a negative data 
element is displayed with a trailing minus sign (-). If the last characters 
of the edit string are CR (for CREDIT) or DR (for DEBIT), the data element is 
displayed with a trailing CR or DR, respectively. 
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EXAMPLES : 


Data Element's Value EDIT MASK Displayed Value 














































1234 $$,$$$.** $12.34 
123456 $$. ss$.7* $1,234.56 
123456 HK HHS A *$1,234.56 
000009 ZUZzZ.~* 09 

-123456 $$,$$$.°°CR $1,234.56CR 
810807 ANGER PES 81/08/07 
=323 $$,$$$.%*- $1.23- 

1234 ZLZZ ! 1234. 

-012345 none -012345 
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OVERVIEW 


A set of commands is provided by Dictionary/3000's DICTDBM program. These 
commands are used to create and maintain entries in a data dictionary. Each 
command is used with a sub-command to identify the entity that receives the 
action of the command. In addition, a HELP command provides a summary of 
commands and their sub-commands on demand. | 


A full description of each command appears later in this section. Each 
description includes: 


definition of the command; 

proper syntax of the command; 
explanation of how the command works; 
example of each command. 


NOTE: Throughout this section, maximum sizes are given in parentheses. 
For example: “Enter the name of the data element (20 characters)" 
means that up to 20 characters can be entered. 


Selecting Defaults 


Whenever a choice between "Y/N" or "N/Y¥" is given, the value to the left of 
the slash is always assumed (the default choice), unless otherwise specified. 
If RETURN is pressed as a response to the prompt, the default is used. A 
response other than a "“Y", "N", "YES", "NO", or RETURN is treated as if the 
default were chosen. 


Table 4.1 lists the commands and summarizes the function of each command. 
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Table 4.1 Summary of DICTDBM Commands 


FUNCTION 


ADD | Adds an association entry. 

CHANGE Changes attributes of entity within a relationship. 

CREATE Creates an entry for a new entity. 

DELETE Deletes an association entry. 

DISPLAY Displays entry information. 

EXIT Terminates the DICTDBM program. 

HELP Briefly describes the functions of DICTDBM commands 
and sub-commands. 

LIST Lists entries. 

MODIFY Modifies an entry. 

PURGE Purges an entry. 

RELATE Establishes a hierarchical relationship entry. 

REMOVE Removes a hierarchical relationship entry. 

RENAME Renames an existing entity. 

REORDER Reorders entities within a relationship entry. 

REPORT Generates a sorted listing of data element entries. 

RESEQUENCE | Resequences entities within an association entry. 

SECURE Assigns security for a file's data elements. 

SHOW Shows hierarchical relationship and association entries. 

UPDATE Updates an association entry. 
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ADD 


Adds an association between unlike entities. 


[option] ADD sub-command 


A 





You use the ADD command to associate an element, a file, or a procedure with 
an entity specified by the sub-command. The association is one of ownership. 
A complete list of entities for which an association can be made is given 
below under Sub-commands. 


The sub-command identifies the type of entity for which an association is 
made. For example, if you use ADD CATEGORY, an association between a category 
and a data element is made; similarly ADD FILE-LOC associates a file toa 
physical location. Like entities can not be associated through the ADD 
command. (See the RELATE command for how to relate like entities. ) 


An association cannot be made between an element and another entity that has 
a subordinate entity related to it. One exception to this is procedures; any 
PROCEDURE can have elements associated with it. 

Data elements added to an entity are ordered in the order in which they were 
added. This order can be changed through the RESEQUENCE command. 


Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - adds a data element to a category 

CLASS - adds a data element to a user security class 
CLASS -FILE - adds a file to a user security class 

FILE - adds a data element to a file 

FILE-LOC - adds a file to a physical location 

GROUP - adds a data element to an HP Inform/3000 group 
PROCEDURE - adds a data element to a procedure 
PROCEDURE-LOC - adds a procedure to a physical location 


ADD 


Example 

>»ADD CATEGORY 

CATEGORY> Finance < Existing category. 
ELEMENT> Customer-account < Adds an element to a category. 
ELEMENT ALIAS> < 
DESCRIPTION> Customer-account information used by Finance. < 
> < 
ELEMENT > < 

> New command prompt. 
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Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. Two asterisk (**) next 
to a prompt indicate that this prompt and those which follow are repeated 
until RETURN is pressed in response to this prompt. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
ADD CATEGORY CATEGORY * 


ELEMENT as 
ELEMENT ALIAS 
DESCRIPTION 


ADD CLASS CLASS 3 
ELEMENT ae 
ACCESS CAPABILITY * 


DESCRIPTION 
ADD CLASS ~-FILE CLASS = 
FILE ala 


ACCESS CAPABILITY (* and issued only if file 
is MAST, DETL, or AUTO) 
DESCRIPTION 


ADD FILE FILE * 
1. if FILE is MAST, MPEF, or FORM file 
ELEMENT ** (prompt is KEY ELEMENT if 
first one added to MAST) 
ELEMENT ALIAS 
DESCRIPTION 
2. if FILE is AUTO file 
KEY ELEMENT ** 
ELEMENT ALIAS 
DESCRIPTION 
3. if FILE is DETL file 
ELEMENT ** 


ELEMENT ALIAS 
PATH MASTER FILE (* if element is to be a 


ADD 


ADD 


ADD 


ADD 


ADD 


PROCEDURE-LOC 


search item) 
PATH SORT ELEMENT (issued if PATH MASTER FILE 
responded to) 
(* if element's chain is to 
be sorted) 
PRIMARY PATH(N/Y) (issued if PATH MASTER FILE 
responded to) 
(* if element defines the 
primary path) 
DESCRIPTION 


if FILE is KSAM file 
ELEMENT KK 


ELEMENT ALIAS 
KEY ELEMENT (N/Y) (* if element is a KEY 


element ) 
DESCRIPTION 
LOCATION * 
FILE “x 
FILE ALIAS 


FILE SIZE (issued only if file type is 
MPEF or KSAM) 
DESCRIPTION 


GROUP 


ELEMENT ae 

ELEMENT ALIAS 

FILE 

PARENT FILE (issued only if file belongs to 
more than one data base) 

VALUE AS A LINK 

DISPLAY ELEMENT ON MENU (Y/N)? 


DESCRIPTION 
PROCEDURE * 
ELEMENT: E® 
ELEMENT ALIAS 
DESCRIPTION 
LOCATION * 


PROCEDURE A 
PROCEDURE ALIAS 
DESCRIPTION 


Prompts 


ADD 


Depending on the sub-command you use, one or more of the following prompts is 


issued: 


ACCESS CAPABILITY > 


CATEGORY > 


CLASS > 


DESCRIPTION > 


DISPLAY ELEMENT 


ON MENU (Y/N)? > 


ELEMENT > 


ELEMENT ALIAS > 


Enter the type of capability to be given to the user 
security class for the file or element as follows: 


If the sub-command is: 
1. CLASS-FILE - enter one of the following: 
= read only 


read, write, modify 
= null read/write list "(/)" 


“x = 
' 


2. CLASS - enter one of the following: 


= read only 
read and update only 
= read, write and modify 
= null read/write list "(/)" 


i a ©) 


Refer to the IMAGE/3000 Reference Manual for a detailed 
explanation of the meanings of the user class access 
capabilities. 


Enter the name of an existing category (20 characters). 


Enter a numeric value which is the identifying number of 
an existing user security class (0 to 9999). 


Enter the textual description which describes the 
association between the entities (50 characters per line, 
unlimited number of lines). 


Enter a response to specify whether you want the element 
to be displayed for reporting on HP Inform/3000's Data 
Names Menu. 


Enter the name of an existing data element which is the 
primary element (20 characters). 


Enter the name by which the data element is known within 
the file (15 characters if FORM, 16 if MAST, AUTO, or 
DETL, and 20 if MPEF or KSAM); category (60 characters) ; 
HP Inform/3000 group (20 characters); or procedure (16 
characters). DEFAULT: If RETURN is pressed in response to 
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FILE 


this prompt, the alias becomes the same as the primary 
element name, except for files, when the first 16 
characters of the primary name are used. 


Note that HP Inform/3000 and Report/3000 will be unable 
to retrieve the values of an element from an IMAGE data 
set if the alias name entered in response to the ELEMENT 
ALIAS prompt of the ADD FILE command string is not the 
same as the actual name of the data element in the data 
set. 


Enter the name of an existing file (20 characters). Four 
sub-commands give this prompt and each one places a 
requirement on the file as follows: 


If the sub-command is: 


1. FILE - the file type must be one of the 
following: 


MAST = IMAGE manual master data set 
AUTO = IMAGE automatic master data set 
DETL = IMAGE detail data set 

KSAM = KSAM file 

MPEF = MPE sequential file 

FORM = VPLUS form 


2. CLASS-FILE - the file type must be one of the 
following: 


MAST = IMAGE manual master data set 
AUTO = IMAGE automatic master data set 
DETL = IMAGE detail data set 

KSAM = KSAM file 

MPEF = MPE sequential file 

VPLS = VPLUS forms file 


3. FILE-LOC - the file type must be one of the 
following: 


BASE = IMAGE data base 
KSAM = KSAM file 

MPEF = MPE sequential file 
VPLS = VPLUS forms file 


4. GROUP - the file must have at least one parent 
(BASE) if it is type MAST, AUTO, or DETL 
and the element must have previously been 
associated with the file. 


FILE ALIAS 


FILE SIZE 


GROUP 


KEY ELEMENT 


LOCATION 


PARENT FILE 


PATH MASTER FILE 


PATH SORT ELEMENT 


PRIMARY PATH(N/Y) 


> 


> 
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Enter the name by which the file is known within the 
location (8 characters). DEFAULT: If RETURN is pressed in 
response to this prompt, the alias name becomes the first 
8 characters of the file name. 


Enter an integer value for the number of records of the 
file in the location (0 to 999999999). Default is 0. 


Enter the name of an existing HP Inform/3000 group (20 
characters). 


Enter the name of an existing data element (20 
characters) that is the search item and only item for an 
AUTO (IMAGE automatic master set), or is the first 
element to be added to a MAST (IMAGE manual master set) 
file. 


Enter the name of an existing location (20 characters). 


Enter the name of an existing file (20 characters) that 
is the parent of the data base set specified in response 
to the FILE prompt. The file type must be type BASE 
(IMAGE data base). 


Enter the name of an existing file (20 characters) of 
type MAST or AUTO which is the chain header for a detail 
set path. DEFAULT: Pressing RETURN in response to this 
prompt indicates that the element is not to be a search 
item. 


Enter the name of an existing data element (20 
characters) that is the sort item for a sorted chain. 
This prompt is issued if a master data set's name was 
given in response to the prompt for PATH MASTER FILE. 
DEFAULT: Pressing RETURN in response to this prompt 
indicates that this is not a sorted chain path. 


If the element is a search item, a "Y" indicates that it 
is the primary path for the detail data set. 


NOTE: If a primary path has already been specified during 
the current prompting cycle of the ADD FILE command 
string, this prompt is not issued. Next time the ADD 
FILE command string is issued and the file is an IMAGE 
detail data set, this prompt is issued again; however, 
responding "Y" to this prompt now results in the prompt 
PRIMARY ALREADY EXISTS, CONTINUE(Y/N)? The default 
response of "Y" makes this the primary path and cancels 
the primary path previously identified; responding "N" 
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PROCEDURE 


PROCEDURE ALIAS 


VALUE AS A LINK 


> 


> 


does not make this the primary path and the primary path 
previously identified remains active. 


Enter the name of an existing procedure (20 characters). 


Enter the name by which the procedure is known within the 
location (8 characters). DEFAULT: If RETURN is pressed in 
response to this prompt, the alias becomes the first 8 
characters of the procedure name. 


Enter -1, 0, or a positive integer to specify which 
elements should preferably be used in linking files. The 
numbers indicate the following: 


mee The element can not be used for linking. 


0 The element may or may not be used for 
linking (DEFAULT). 


l or greater The element should be used as a link when 
possible; elements assigned a positive link 
value form a prioritized list to be used 
when it is necessary to link files (the 
lower the positive integer, the higher the 
priority). 


CHANGE 


Changes the attributes of a child within a relationship or the description of 
the relationship which was established with the RELATE command. 


[option] CHANGE sub-command 


CHG 





You use the CHANGE command to change the attributes of a child entity in a 
relationship or the description of a relationship which was established with 
the RELATE command. A complete list of what can be changed is given below 
under Sub-commands. 


You use the sub-command to identify the type of parent entity that defines 
the relationship. For example, if you use CHANGE ELEMENT, you change the 
starting position of a child element within the parent element and/or edit 
the textual description describing the relationship. 

Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - changes a category to category description 


ELEMENT - changes an element to element entry and/or description 
FILE - changes a file to file entry and/or description 
GROUP - changes an HP Inform/3000 group to group description 


PROCEDURE - changes a procedure to procedure description 


Example 


>CHANGE ELEMENT 


PARENT ELEMENT> Name < Enter the parent's name. 
CHILD ELEMENT> First-name <« The child to be changed. 
EDIT DESCRIPTION(Y/N)? N "N" to go directly to 
- attributes. 
POSITION: Existing attribute information. 
l 
START POSITION> 4 < Identifies new position of 
child within parent's list. 
CHILD ELEMENT> < RETURN to terminate command. 
> New command prompt. 


CHANGE 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. Two asterisks (**) 
next to a prompt indicate that this prompt and those which follow are 
repeated until RETURN is pressed in response to this prompt. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
CHANGE CATEGORY PARENT CATEGORY * 


CHILD CATEGORY ale 
EDIT COMMAND>> x 


CHANGE ELEMENT PARENT ELEMENT = 

CHILD ELEMENT em 

EDIT DESCRIPTION (Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 

EDIT ATTRIBUTES (Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 

START POSITION 


CHANGE FILE PARENT FILE * 

CHILD FILE xx 

EDIT DESCRIPTION (Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION ) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION ) 

CHILD ALIAS 

CAPACITY (issued if PARENT file is type BASE) 

BLOCKMAX (issued if PARENT file is type BASE) 


CHANGE GROUP PARENT GROUP * 
CHILD GROUP we 
EDIT COMMAND>> “ 
CHANGE PROCEDURE PARENT PROCEDURE “ 
CHILD PROCEDURE Re 
EDIT COMMAND >> * 


Prompts 


CHANGE 


Depending on the sub-command you use, one or more of the following prompts is 


issued: 


BLOCKMAX 


CAPACITY 


CHILD ALIAS 


CHILD CATEGORY 


CHILD ELEMENT 


CHILD FILE 


CHILD GROUP 


CHILD PROCEDURE 


EDIT : 
ATTRIBUTES (Y/N) 


EDIT COMMAND >> 
EDIT 
DESCRIPTION (Y/N) 


PARENT CATEGORY 


PARENT ELEMENT 


> 


> 


> 


> 


> 


> 


> 


Enter a new maximum physical block length value (in 
words) for the child file within the parent file (128 - 
2048). DEFAULT: Pressing RETURN in response to this 
prompt indicates no change. © 


Enter a new value for the maximum number of entries for 
the child file (1 to 999999999). DEFAULT: Pressing RETURN 
in response to this prompt indicates no change. 


Enter a new alias name for the child file (16 
characters). DEFAULT: Pressing RETURN in response to this 
prompt indicates no change. 


Enter the name of an existing category that is the child 
category in the entry (20 characters). 


Enter the name of an existing data element that is the 
child in the entry (20 characters). 


Enter the name of an existing file that is the child in 
the entry (20 characters). 


Enter the name of an existing HP Inform/3000 group that 
is the child in the entry (20 characters). 


Enter the name of an existing procedure that is the child 


in the entry (20 characters). 


Enter an "N" to not generate prompts for attributes. 
(see Sub-command Prompts for which attributes can be 
changed). 


Enter one of the EDIT COMMANDS described in Section III. 
Enter an "N" if editing is not to be done for the textual 
description of the relationship. 


Enter the name of an existing category that is the parent 
in the entry (20 characters). 


Enter the name of an existing element that is the parent 
in the entry (20 characters). 
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PARENT FILE 


PARENT GROUP 


PARENT PROCEDURE 


START POSITION 


> 


> 


> 


Enter the name of an existing file that is the parent in 
the entry (20 characters). 


Enter the name of an existing HP Inform/3000 group that 
is the parent in the entry (20 characters). NOTE: $MENU 
can not be changed. 


Enter the name of an existing procedure that is the 
parent in the entry (20 characters). 


Enter a positive integer which is the new byte position 
of the start of the child element's data field within the 
parent element (1 to 9999). DEFAULT: Pressing RETURN in 
response to this prompt indicates no change. 


CREATE 


Creates a new entity. 


[option] CREATE sub-command 


Cc 





You use the CREATE command to define a new entity in the dictionary. A 
complete list of entities that can be created is given below under 
Sub-commands. 


The sub-command identifies the type of entity that you are defining. For 
example, if you use CREATE GROUP, you create a new HP Inform/3000 group. 


You must CREATE an entity before you can use it with any other command. 


Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - creates a new category 

CLASS - creates a new user security class 
ELEMENT - creates a new data element 

FILE - creates a new file . 

GROUP - creates a new HP Inform/3000 group 
LOCATION - creates a new physical location 
PROCEDURE - creates a new procedure 


Example 


>CREATE GROUP 


GROUP> Customer Information< HP Inform/3000 group. 
LONG NAME> Customer Information-Marketing < 
TYPE> MRKT< User defined type. 
RESPONSIBILITY> Order Processing < 
DESCRIPTION> This group will contain detail < 


> information about Marketing's customers. 
> < 
RETURN to end command. 
> New command prompt. 


CREATE 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 


COMMAND SUB-COMMAND PROMPT 


CREATE CATEGORY CATEGORY x 
LONG NAME 
TYPE 
RESPONSIBILITY 
DESCRIPTION 


CREATE CLASS CLASS * 
NAME 
TYPE 
PASSWORD 
RESPONSIBILITY 
RESTRICT CLASS TO A FILE (N/Y) 
FILE (* if Yes to RESTRICT CLASS; 
file must be of type BASE) 
DESCRIPTION 


CREATE ELEMENT ELEMENT * 
LONG NAME 
TYPE 
SIZE (* and issued only if TYPE specified) 
DECIMAL (issued only if TYPE specified and 
if TYPE is numeric) 
STORAGE LENGTH(n) (issued only if TYPE was 
specified) 
COUNT(1) (issued only if TYPE was specified) 
HEADING TEXT 
ENTRY TEXT 
EDIT MASK 
MEASUREMENT UNITS 
RESPONSIBILITY 
DESCRIPTION 


CREATE FILE FILE * 
LONG NAME 
TYPE * 
RESPONSIBILITY 
DESCRIPTION 


CREATE 


CREATE GROUP GROUP * 
LONG NAME 
TYPE 
RESPONSIBILITY 
DESCRIPTION 


CREATE LOCATION LOCATION * 
LONG NAME 
GROUP 
ACCOUNT 
CPU 
DESCRIPTION 


CREATE PROCEDURE PROCEDURE sd 
LONG NAME 
TYPE 
LANGUAGE 
RESPONSIBILITY 
DESCRIPTION 


CREATE 


Prompts 


Depending on the sub-command you use, one or more of the following prompts is 


issued: 


ACCOUNT 


CATEGORY 


CLASS 
COUNT (1) 
CPU 


DECIMAL 


DESCRIPTION 


EDIT MASK 


ELEMENT 


ENTRY TEXT 


Enter the name for the MPE account associated with the 
location (8 characters) 


Enter the name for a new category (20 characters). 


Enter a numeric value for the identity of a new security 
class (0 to 9999). 


Enter the sub-element count if the data element is a 
compound element (1 to 9999). DEFAULT is 1. 


Enter the identity of the machine associated with the 
location (8 characters). 


Enter the integer value for the number of digits to the 
right of the decimal point (0 to 9999). Do not include a 
position for the decimal point itself. The largest value 
for each element type is as follows: 


27 decimal digits for types Z, P, and 9; 
28 decimal digits for types I, J, and K; 
9999 decimal digits for types E and R. 


This prompt is only issued for numeric type data 
elements. Note if the maximum value for SIZE is entered, 
a decimal value is required. DEFAULT is 0. 


Enter a textual description which describes the entity 
(50 characters per line, unlimited lines). 


Enter a textual edit mask to be used by HP Inform/3000, 
Report/3000, and Transact/3000 to edit values when 
displayed for the data element (30 characters). (Refer to 
Using Edit Masks in Section III.) 


Enter the name for a new data element (20 characters). 


Enter textual information to be used by HP Inform/3000, 
Report/3000, and Transact/3000 as a prompt for input. 
Otherwise, the primary name is used in the prompt (30 
characters). 


Note that the primary name will be used in HP 
Inform/3000's and Report/3000's SELECTION CRITERIA prompt 
unless an ENTRY TEXT has been specified. 


FILE 


GROUP 


HEADING TEXT 


LANGUAGE 


LOCATION 


LONG NAME 


MEASUREMENT UNITS 


NAME 


PASSWORD 


PROCEDURE 


RESPONSIBILITY 


> 


> 


CREATE 


If the sub-command is: 
1. FILE - enter the name for a new file (20 characters). 


2. CLASS - enter the name of an existing file of type 
BASE (20 characters). 


If the sub-command is: 


1. GROUP - enter the name for a new HP Inform/3000 
group (20 characters). 


2. LOCATION - enter the name of the MPE group associated 
with the location (8 characters). 


Enter a textual heading to be used by HP Inform/3000, 
Report/3000, and Transact/3000 for reports. Otherwise 
the primary name is used in the heading (30 characters). 


Note that the primary name will be used in the report 
heading by HP Inform/3000 and Report/3000 unless a 
HEADING TEXT has been specified. 


Enter the name of the implementation language for the 
procedure (10 characters). 


Enter the name of a physical location that identifies the 
MPE file group and account, and the machine where files 
and procedures reside (20 characters). 


Enter a full textual description for the entity (50 
characters). 


Enter the type of measurement units (such as feet, 
dollars) used for the data element's value (10 
characters). 


Enter a textual name for the new security class (50 
characters). 


Enter a password for the new security class (8 
characters). 


Enter the name for a new procedure (20 characters). 
Enter the name of the person, department, or area 


responsible for the integrity of the new entity (20 
characters). 


CREATE 


RESTRICT CLASS 
TO A FILE (N/¥) > 


SIZE > 


STORAGE LENGTH(n) > 


TYPE > 


Enter a "Y" if the scope of the class is to be restricted 
to one file. A security class can be restricted to files 
of type BASE. 


Enter an integer value required to display an element (1 
to 9999). Include a position for a decimal point if there 
is one, but do not include one for a sign. The largest 
value for each element type is as follows: 


28 digits for type Z, P, and 9; 
29 digits for type I, J, and K; 
9999 digits for type E, R, X, and U. 


The system calculates the storage length in bytes and 
displays it as "n". An over-ride value may be entered (1 
to 9999), otherwise "n" is used. 


If the sub-command is: 
1. ELEMENT - enter one of the following values: 


= upper case ASCII 

= upper or lower case ASCII 

= numeric ASCII 

= zoned decimal 

= packed decimal 

= integer binary 

= integer binary (COBOL) 

= logical 

= floating point (commercial) 
= floating point (E format) 


PWD AROUOHD NOK G 


If the type is numeric, a plus character (+) may 
immediately follow it to indicate that the data 
element can have only positive values. If a plus 
character is entered with a type other than numeric, 
it is ignored. Pressing RETURN in response to this 
prompt indicates that the data element does not have a 
type assigned. 


2. FILE - enter one of the following values: 


BASE = IMAGE data base 

MAST = IMAGE manual master data set 
AUTO = IMAGE automatic master data set 
DETL = IMAGE detail data set 

KSAM = KSAM file 

MPEF = MPE sequential file 


CREATE 


VPLUS forms file 
VPLUS form 


VPLS 
FORM 


3. CATEGORY, CLASS, GROUP, or PROCEDURE - enter up to 
four characters meaningful 
to you. 


DELETE 


Deletes an association which was established with the ADD command. 


[option] DELETE sub-command 


DEL 





You use the DELETE command to delete an association between unlike entities 
which was established with the ADD command. Only the association is deleted, 
not the entities. A complete list of associations that can be deleted is 
given below under Sub-commands. 


You use the sub-command to identify the entity from which an assocation is to 


be deleted. For example, if you use DELETE CLASS, you delete an association 
of an element to a security class. 


Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - deletes an element to category association 

CLASS - deletes an element to class association 

CLASS -FILE - deletes a file to class association 

FILE - deletes an element to file association 

FILE-LOC - deletes a file to location association 

GROUP ~ deletes an element to HP Inform/3000 group association 
PROCEDURE - deletes an element to procedure association 


PROCEDURE-LOC - deletes a procedure to location association 


Example 
>DELETE CLASS 


CLASS> 100 < Security class used in 
the association. 
ELEMENT> Name < Element to be deleted 
ENTRY DELETED from the association. 


ELEMENT > ' RETURN to terminate the 
command. 
> New command prompt. 


DELETE 


Sub-command Prompts 


For the prompts shown with an asterisk (*}, you must enter a response other 
than RETURN in order to implement the command string. Two asterisks (**) 
next to a prompt indicate that this prompt and those which follow are 
repeated until RETURN is pressed in response to this prompt. 


You enter: 


COMMAND SUB-COMMAND 


DELETE CATEGORY 


DELETE CLASS 


DELETE CLASS -FILE 


DELETE FILE 


DELETE FILE-LOC 


DELETE GROUP 


DELETE PROCEDURE 


DELETE PROCEDURE-LOC 


You are prompted for: 

PROMPT 

CATEGORY * 
ELEMENT ** 


CLASS 
ELEMENT x 


CLASS * 
FILE has 
FILE * 


ELEMENT ne 


LOCATION rp 
FILE aK 


GROUP * 
ELEMENT as 


PROCEDURE = 
ELEMENT bas 


LOCATION * 
PROCEDURE ** 


DELETE 


Depending on the sub-command you use, one or more of the following prompts is 


l. 


2. 


Prompts 

issued: 

CATEGORY > 
CLASS > 
ELEMENT > 
FILE > 
GROUP > 
LOCATION > 
PROCEDURE > 


de 


2 


Enter the name of an existing category used in the 
association (20 characters). 


Enter the identifying number of an existing security 
class used in the association (1 to 9999). 


Enter the name of an existing data element which is to be 
deleted from the association (20 characters). 


If the sub-command is: 


FILE - enter the name of an existing file used in the 
the association (20 characters). 


FILE-LOC or CLASS-FILE - enter the name of an existing 
file which is to be deleted from the association 
(20 characters). 


Enter the name of an existing HP Inform/3000 group used 
in the association (20 characters). 


Enter the name of an existing physical location used in 
the association (20 characters). 


If the sub-command is: 


PROCEDURE - enter the name of an existing procedure 
used in the association (20 characters). 


PROCEDURE-LOC - enter the name of an existing procedure 
which is to be deleted from the 
association (20 characters). 


DISPLAY 


Displays information about an entity established with the CREATE, ADD, and/or 
RELATE commands. 


[option] DISPLAY sub-command 


D 





You use the DISPLAY command to display the attributes of an entity and, for 
some, the direct relationships and the direct associations. A direct 
relationship is the parent of the entity and a direct association is the 
entity that owns the displayed entity. 


The sub-command identifies the entity to be displayed. If you use element, 
file, or procedure as the sub-command, you see attribute, relationship, and 
association information. If you use category or group, you see attribute and 
relationship information. For class or location, you see attribute 
information. A complete list of entities that can be displayed is given 
below under Sub-commands. 


You can use Selection Criteria to select the entity or entities to be 
displayed. Refer to Using Selection Criteria in Section III. 


If you respond with an exclamation mark (!) or with RETURN to the first (and 
only) prompt, the command string will be implemented for all entities of that 
sub-command type. That is, attribute information and, for some sub-commands, 
the direct relationships and direct associations are displayed for all 
entities for that sub-command. (Note that this is a different use of the 
exclamation mark and of RETURN than for most commands. ) 


- When you use the PRINT option with the command string, descriptive 
information is printed in addition to the information normally displayed on 
the terminal. The description information is the information that was entered 
when the relationship or association was made. 


DISPLAY 


Sub-commands 
Any one of the following sub-commands can be used: 


CATEGORY - displays attribute information for a category plus all 
the directly related categories 


CLASS - displays attribute information for a user security class 
ELEMENT - displays attribute information for an element plus the 
directly associated and/or directly related entities 
FILE - displays attribute information for a file plus the 
directly associated and/or directly related entities 
GROUP - displays attribute information for an HP Inform/3000 


group plus the directly related entities 
LOCATION - displays attribute information for a physical location 
PROCEDURE - displays attribute information for a procedure plus the 
directly associated and/or directly related entities 


DISPLAY 


Example 
> DISPLAY ELEMENT 
ELEMENT> ACCOUNT < 
ELEMENT : TYPE: SIZE: DEC: LENGTH: COUNT: RESPONSIBILITY: 
ACCOUNT X 10 OO 10 1 


LONG NAME: MARKETING CUSTOMER ACCOUNT NUMBERS 
HEADING TEXT: CUSTOMER ACCOUNT NUMBERS 
ENTRY TEXT: CUSTOMER ACCOUNT NUMBER 
EDIT MASK: 
MEASUREMENT UNITS: 
DATE CREATED: 81/12/31 BY MARGRITE 
DATE CHANGED: 81/12/31 BY MARGRITE 


DESCRIPTION: 
THIS ACCOUNT NUMBER IDENTIFIES THE CUSTOMERS 
WHO BUY THE LARGE INTEGRATED SYSTEMS. 


FILE: TYPE, ELEMENT (ALIAS) : 
SALES DETL ACCOUNT 
CHAIN MASTER SET: ! CUSTOMER 
SORTED BY: PURCH-NO 


CUSTOMER MAST ACCOUNT 
GROUP : ELEMENT (ALIAS) : LINK: DISPLAY: 
CUSTOMER INFO CUSTOMER ACCOUNT l YES 


FILE: SALES(ORDINV) 


CLASS: CAPABILITY: 


10 M 
20 R 
30 R 
40 R 


1 RECORD FOUND 


DISPLAY 


Sub-command Prompts 


You can enter the name for a specific entity or use SELECTION CRITERIA for 


the prompt. 


(Refer to Using Selection Criteria in Section III.) Responding 


with an exclamation mark (!) or with RETURN will display information about 
all entities for the specified sub-command. 


You enter: 


COMMAND 


DISPLAY 


DISPLAY 


DISPLAY 


DISPLAY 


DISPLAY 


DISPLAY 


SUB-COMMAND 


CATEGORY 


CLASS 


ELEMENT 


FILE 


GROUP 


LOCATION 


You are prompted for: 


PROMPT 


CATEGORY 
CLASS 
ELEMENT 
FILE 
GROUP 


LOCATION 


DISPLAY 


Prompts 
Depending on the sub-command you use, one of the following prompts is issued: 


CATEGORY > Enter the name of an existing category or Selection 
Criteria for which information is to be displayed. 


CLASS > Enter the identifying number of an existing security 
class or Selection Criteria for which information is to 
be displayed. 


ELEMENT > Enter the name of an existing element or Selection 
Criteria for which information is to be displayed. 


FILE > Enter the name of an existing file or Selection Criteria 
for which information is to be displayed. 


GROUP > Enter the name of an existing HP Inform/3000 group or 
Selection Criteria for which information is to be 
displayed. 

LOCATION > Enter the name of an existing physical location or 
Selection Criteria for which information is to be 
displayed. 

PROCEDURE > Enter the name of an existing procedure or Selection 


Criteria for which information is to be displayed. 


HELP 


Provides a brief description of each DICTDBM command and sub-command. 


[option] HELP [sub-command ] 


H 





You use the HELP command to obtain information on: 


@ all DICTDBM commands; 


@ any DICTDBM command and its sub-commands. 


All options except REPEAT can be used with this command. 


To review descriptions of all DICTDBM commands, use the HELP command without 


a sub-command. 


To obtain a description of a specific DICTDBM command and its sub-commands, 
accompany the HELP command with one of. the following sub-commands. 


Sub-commands 


Any one of the following sub-commands can be used to obtain information about. 


the DICTDBM command it names: 


ADD LIST 

CHANGE MODIFY 
CREATE PURGE 
DELETE RELATE 
DISPLAY REMOVE 
EXIT RENAME 


Nov 1982 


REORDER 
REPORT 
RESEQUENCE 
SECURE 
SHOW 
UPDATE 


HELP 


Examples 
> HELP 
ADD -Add an association between unlike entities 
CHANGE -Change entry/description of relationship established with RELATE 
CREATE -Create a new entity 
DELETE -Delete association which was established with the ADD command 
DISPLAY -Display info about entity established with CREATE, ADD, RELATE 
EXIT -Terminate DICTDBM 
HELP -Display information about the commands Enter HELP command-name 
LIST -List information for entity/entities with subset of attributes 
MODIFY -Modify attributes and/or description of an entity 
PURGE -Purge entity and all references to it 
RELATE -Establish hierarchial relationship between like entities 
REMOVE -Remove relationships between entities established with RELATE 
RENAME -Rename an existing entity 
REORDER -Re-position entity within relationship established with RELATE 
REPORT -Report a sorted listing of elements 
RESEQUENCE -Re-position element within association established with ADD 
SECURE -Assign all elements of an IMAGE type file to a security class 
SHOW -Show entity's association and relationships with child entities 
UPDATE -Update association between entities established with ADD 
> HELP ADD 
ADD - Add an association between unlike entities 

CATEGORY - Add an element to a category 

CLASS - Add an element to a user security class 

CLASS=F ILE - Add a file to a user security class 

FILE - Add an element to a file 

FILE=LOC - Add a file to a physical location 

GROUP - Add an element to an INFORM group 

PROCEDURE - Add an element to a procedure 


PROCEDURE-LO - Add a.procedure to a physical location 


4-30a Nov 1982 [ 


LIST 


Lists information for an entity or entities with a subset of the attributes. 


[option] LIST sub-command 


L 





You use the LIST command to see the attributes of: 


® a particular entity; 
@ all entities of a particular type; 
@e entities selected by using Selection Criteria (see Section III). 


A complete list of entities for which a listing can be generated is given 
under Sub-commands. 


The sub-command identifies the type of entity for which a listing is 
generated. The displayed listing is in the order in which the entities were 
entered. After the listing, the number of records displayed is given. 


To list one entity, specify the entity's name in response to the first 
prompt. To list all of the entities for a specific sub-command, press the 
RETURN key for all the prompts or enter an exclamation character (!) in 
response to the first prompt. (Note that this is a different use of the 
RETURN key and of the exclamation mark character than for most commands.) To 
use the Selection Criteria for a listing, see Using Selection Criteria in 
Section III. 


When you use the PRINT option with the command string, descriptive 
information is printed in addition to the information normally displayed on 


the terminal. The descriptive information is the description that was entered 
when the entity was created. 


Sub-commands 
Any one of the following sub-commands can be used: 


CATEGORY - lists the categories 


CLASS - lists the security classes 
ELEMENT - lists the data elements 

FILE - lists the files 

GROUP - lists the HP Inform/3000 groups 
LOCATION - lists the physical locations 


PROCEDURE - lists the procedures 


Nov 1982 4-30b 


LIST 


Example 
> REPEAT LIST ELEMENT 


ELEMENT> PU* | ‘ 


TYPE> ! < 
ELEMENT : TYPE: SIZE: DEC: LENGTH: COUNT: RESPONSIBILITY: 
PUB-DATE X 6 0 6 l M. Sides 
PURCH-DATE X 6 0 6 1 M. Abear 
PURCH-NO U 6 0 6 1 R. Park 
PUBLSHER X 40 0 40 l M. Sides 
4 RECORDS FOUND 
ELEMENT> “T < 
TYPE> |! < 
ELEMENT : TYPE: SIZE: DEC: LENGTH: COUNT: RESPONSIBILITY: 
CREDIT U 2 0 2 ] J. Smith 
SUBJECT X 40 0 40 1 M. Sides 
SQUARE - FEET X 8 0 8 l R. Park 
ACCOUNT X 10 0 10 1 M. Abear 
UNIT-COST P 11 0 6 l M. Abear 
EXISTING-STRUCT U 2 0 2 | J. Smith 
LOAN-AMT P 1] 2 6 1 M. Abear 
7 RECORDS FOUND 
ELEMENT> ] < 


LIST 


Sub-command Prompts 


You can enter specific information for any of the prompts or use SELECTION 
CRITERIA for any of the prompts. (Refer to Using Selection Criteria in 
Section III.) Responding with RETURN to all the prompts or with an 
exclamation mark (!) to the first prompt lists information about all entities 
for the specified sub-command. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
LIST CATEGORY CATEGORY 
TYPE 
RESPONSIBILITY 
LIST CLASS CLASS 
TYPE 
RESPONSIBILITY 
LIST ELEMENT ELEMENT 
TYPE 
SIZE 


DECIMAL (issued only if TYPE is numeric) 
STORAGE LENGTH 

COUNT 

RESPONSIBILITY 


LIST FILE FILE 
TYPE 
RESPONSIBILITY 


LIST GROUP GROUP 
TYPE 
RESPONSIBILITY 


LIST LOCATION LOCATION 
GROUP 
ACCOUNT 
CPU 


LIST PROCEDURE. PROCEDURE 
TYPE 
LANGUAGE 
RESPONSIBILITY 


Prompts 


LIST 


Depending on the sub-command you use, one or more of the following prompts is 


issued. 


ACCOUNT 


CATEGORY 


CLASS 


COUNT 


CPU 


DECIMAL 


ELEMENT 


FILE 


GROUP 


v 


Enter the name of the existing MPE account or Selection 
Criteria for which information is to be listed. 


Enter the name of the existing category or Selection 
Criteria for which information is to be listed. 


Enter the number of the existing security class or 


Selection Criteria for which information is to be listed. 


Enter the sub-element count if the data element is a 
compound element or Selection Criteria for which 
information is to be listed. 


Enter the name of the machine or Selection Criteria for 
which information is to be listed. 


Enter the integer value for the number of digits to the 
right of the decimal point (0 to 9999) or Selection 
Criteria for which information is to be displayed. Do not 
include a position for the decimal point itself. The 
largest value for each element type is as follows: 


27 decimal digits for types Z, P, and 9; 
28 decimal digits for types I, J, and K; 
9999 decimal digits for types E and R. 


This prompt is only issued for numeric type data 
elements. Note if the maximum value for SIZE is entered, 
a decimal value is required. 


Enter the name of the existing data element or Selection 
Criteria for which information is to be listed. 


Enter the name of the existing file or Selection Criteria 
for which information is to be listed. 


If the sub-command is: 
GROUP - enter the name of an existing HP Inform/3000 


group or Selection Criteria for which 
information is to be listed. 


. LOCATION - enter the name of an existing MPE group or 


Selection Criteria for which information is 
to be listed. 


LIST 


LANGUAGE 


LOCATION 


PROCEDURE 


RESPONSIBILITY 


SIZE 


STORAGE LENGTH 


TYPE 


Ls 


Zs 


3. 


Enter the name of the implementation language or 
Selection Criteria for which information is to be listed. 


Enter the name of the physical location or Selection 
Criteria for which information is to be listed. 


Enter the name of the existing procedure or Selection 
Criteria for which information is to be listed. 


Enter the name of the person, department, or area, or 
Selection Criteria for which information is to be listed. 


Enter an integer value required to display an element (1 
to 9999) or Selection Criteria for which information is 
to be listed. Include a position for a decimal point if 
there is one, but do not include one for a sign. The 
largest value for each element type is as follows: 


28 digits for type Z, P, and 9; 
29 digits for type I, J, and K; 
9999 digits for type E, R, X, and U. 


Enter the storage length in bytes or Selection Criteria 
for which information is to be displayed. 


If the sub-command is: 


ELEMENT - enter the attribute type or Selection Criteria 
for which information is to be listed. 


FILE - enter the file type or Selection Criteria for 
which information is to be listed. 


‘CATEGORY, CLASS, GROUP, PROCEDURE - enter the character 
value or Selection Criteria for which 
information is to be listed. 


MODIFY 


Modifies the information for an entity which was created with the CREATE 
command. . 





[option] MODIFY sub-command 
M 


You use the MODIFY command to change the attributes. and/or the description of 
an entity created with the CREATE command. If you choose to edit the 
description, you will be prompted to enter an EDIT COMMAND. Refer to Using 
Edit Description Commands in Section III for a complete list of EDIT 
COMMANDs. 


The sub-command identifies the type of entity to be modified. For example, 
if you use MODIFY CATEGORY, you can enter a new type designator, change the 
name of the person responsible, or enter a new textual name for the category. 
You can also edit the textual description for the category. A complete list 
of entities that can be modified is given below under Sub-commands. 
Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - modifies a category 


CLASS - modifies a security class 
ELEMENT - modifies a data element 

FILE - modifies a file 

GROUP - modifies an HP Inform/3000 group 


LOCATION - modifies a physical location 
PROCEDURE - modifies a procedure 


Example 
>MODIFY CATEGORY 
. CATEGORY> Marketing < Category to be modified. 

EDIT DESCRIPTION(Y/N)? n No, to edit description. 
CATEGORY: TYPE: RESPONSIBILITY: 
Marketing . SPLS John Williams 

LONG NAME: 

TYPE> Attribute prompt. 
RESPONSIBILITY> James Max Changed name. 


LONG NAME> Marketing Supplies Sales Added information. 


> New command prompt. 


MODIFY 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
MODIFY CATEGORY CATEGORY * 


EDIT DESCRIPTION(Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 

TYPE 

RESPONSIBILITY 

LONG NAME 


MODIFY CLASS CLASS * 

EDIT DESCRIPTION(Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 

TYPE 

PASSWORD 

RESPONSIBILITY 

LONG NAME 

RESTRICTED FILE 


MODIFY ELEMENT ELEMENT it 

EDIT DESCRIPTION(Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 

TYPE 

SIZE 

DECIMAL 

STORAGE LENGTH(n) 

COUNT 

RESPONSIBILITY 

LONG NAME 

HEADING TEXT 

ENTRY TEXT 

EDIT MASK 

MEASUREMENT UNITS 


MODIFY 


MODIFY FILE FILE * 
EDIT DESCRIPTION (Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION ) 
EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 
TYPE (issued only if the file has not been 
associated or related to any other 
entity ) 
RESPONSIBILITY 
LONG NAME 


MODIFY GROUP GROUP * 
EDIT DESCRIPTION(Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION ) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 

TYPE 

RESPONSIBILITY 

LONG NAME 


MODIFY LOCATION LOCATION * 

EDIT DESCRIPTION(Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 

EDIT DESCRIPTION) 

GROUP 

ACCOUNT 

CPU 

LONG NAME 


MODIFY PROCEDURE PROCEDURE * 

EDIT DESCRIPTION(Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION ) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 

TYPE 

LANGUAGE 

RESPONSIBILITY 

LONG NAME 


MODIFY 


Depending on the sub-command you use, one or more of the following prompts is 


Prompts 

issued: 

ACCOUNT — > 
CATEGORY > 
CLASS > 
COUNT > 
CPU > 
DECIMAL > 
EDIT 


ATTRIBUTES(Y/N)? > 
EDIT COMMAND>> > 
EDIT 

DESCRIPTION(Y/N)}? > 


EDIT MASK > 


Enter a new name for the MPE account that is associated 
with the location (8 characters). DEFAULT: Pressing 
RETURN in response to this prompt indicates no change. 


Enter the name of an existing category (20 characters). 


Enter the identifying number of an existing security 
class (0 to 9999), 


Enter a positive integer value for a new sub-element 
count if the data element is a compound type (1 to 9999). 
DEFAULT: Pressing RETURN in response to this prompt 
indicates no change. 


Enter the new name of the machine that is associated with 
the location (8 characters). DEFAULT: Pressing RETURN in 
response to this prompt indicates no change. 


Enter a new integer value for the number of digits to the 
right of the decimal point (0 to 9999). Do not include a 
position for the decimal point itself. The largest value 
for each element type is as follows: 


27 decimal digits for types Z, P, and 9; 
28 decimal digits for types I, J, and K; 
9999 decimal digits for types E and R. 


Note if the maximum value for SIZE is entered, a decimal 
value is required. DEFAULT: Pressing RETURN in response 
to this prompt indicates no change. 


Enter an "N" if attribute prompts are not to be issued. 
Enter one of the EDIT COMMANDS described under Using Edit 
Description Commands in Section III. 

Enter an "N" if description text editing is not required. 
Enter a new textual edit mask to be used to edit values 
when displayed for the data element (30 characters). This 


is used by HP Inform/3000, Report/3000, and 
Transact/3000. (Refer to Using Edit Masks in Section 


ELEMENT 


ENTRY TEXT 


FILE 


GROUP 


HEADING TEXT 


LANGUAGE 


LOCATION 


LONG NAME 


MEASUREMENT UNITS 


> 


MODIFY 


III.) DEFAULT: Pressing RETURN in response to this 
prompt indicates no change. 


Enter the name of an existing data element (20 
characters). 


Enter new textual information to be used by HP 
Inform/3000, Report/3000, and Transact/3000 as a prompt 
for input. This text replaces the primary name in the 
prompt (30 characters). DEFAULT: Pressing RETURN in 
response to this prompt indicates no change. 


Enter the name of an existing file (20 characters). 
If the sub-command is: 


1. GROUP - enter the name of an existing HP 
Inform/3000 group (20 characters). NOTE: 
SMENU can not be modified. 


2. LOCATION - enter the name of a new MPE group to be 
associated with the location (8 
characters). DEFAULT: Pressing RETURN in 
response to this prompt indicates no 
change. 


Enter a new textual heading to be used by HP Inform/3000, 
Report/3000, and Transact/3000 for the heading in 
reports. This heading replaces the data element's 
primary name in reports (30 characters). DEFAULT: 
Pressing RETURN in response to this prompt indicates no 
change. 


Enter the name of a new implementation language for the 
procedure (10 characters). DEFAULT: Pressing RETURN in 
response to this prompt indicates no change. 


Enter the name of an existing physical location (20 
characters). 


Enter a new full textual name for the entity (50 
characters). DEFAULT: Pressing RETURN in response to this 
prompt indicates no change. 


Enter a new type of measurement units (such as feet, 
dollars) for the data element's value (10 characters). 
DEFAULT: Pressing RETURN in response to this prompt 
indicates no change. 


MODIFY 


PASSWORD > 


PROCEDURE > 


RESPONSIBILITY > 


RESTRICTED FILE > 


SIZE > 


STORAGE LENGTH(n) > 


TYPE > 


Enter a new password for the user security class (8 
characters). A blank value (pressing the space bar 

followed by RETURN) removes the password. DEFAULT: 

Pressing RETURN following this prompt indicates no 

change. 


Enter the name of an existing procedure (20 characters). 


Enter a new name for the person, department, or area 
responsible for the integrity of the entity (20 
characters). DEFAULT: Pressing RETURN in response to 
this prompt indicates no change. 


If the scope of the security class is to be limited to a 
file, enter the name of the file (20 characters). The 
file type must be BASE. DEFAULT: Pressing RETURN in 
response to this prompt indicates no change. 


Enter a new integer value required to display an element 
(1 to 9999). Include a position for a decimal point if 
there is one, but do not include one for a sign. The 
largest value for each type is as follows: 


28 digits for type Z, P, and 9; 
29 digits for type I, J, and K; 
9999 digits for type E, R, X, and U. 


DEFAULT: Pressing RETURN in response to this prompt 
indicates no change. 


The calculated storage length in bytes is displayed as 
"n". An over-ride value may be entered (1 to 9999). 
DEFAULT: Pressing RETURN in response to this prompt 


indicates no change. 
If the sub-command is: 


1. CATEGORY, CLASS, GROUP, or PROCEDURE - enter a new 
user defined type (4 characters). DEFAULT: 
Pressing RETURN in response to this prompt 
indicates no change. 


2. ELEMENT - enter a new type for the data element based 


on the following: 


= upper case ASCII 

= upper or lower case ASCII 
= numeric ASCII 

= zoned decimal 


NwOM CG 
t 


3s 


FILE 


mod AoW 
u 


MODIFY 


= packed decimal 

= integer binary 

= integer binary (COBOL) 
logical 

= floating point (commercial) 
= floating point (E format) 


If the type used is numeric, a plus charater 
(+) following it indicates that the data 


element may have only positive values. 


Ifa 


plus character is used with any other type, 


it is ignored. 


DEFAULT: Pressing RETURN in response to this 


prompt indicates no change. 


enter a new file type based on one of 
following types: 


BASE = IMAGE data base name 
MAST = IMAGE manual master data set 


the 


AUTO = IMAGE automatic master data set 


DETL = IMAGE detail data set 
FORM = VPLUS form 

VLPS = VPLUS form file name 
MPEF = MPE sequential file 
KSAM = KSAM file 


DEFAULT: Pressing RETURN in response to this 


prompt indicates no change. 
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PURGE 


Purges an entity which was created with the CREATE command from the 
dictionary. . 


[option] PURGE sub-command 


P 





You use the PURGE command when you want to delete an entity and all 
references to it from the dictionary. You will be prompted with "Delete all 
entries (N/Y)?" before the entity is purged. A reponse other then "Y" cancels 
the PURGE command. A complete list of which entities can be purged is given 
below under Sub-commands. 


You use the sub-command to identify the kind of entity you want to purge. For 
example, if you use PURGE FILE, the specified file and all references to the 
file are purged from the dictionary. That is, if you purge a master file and 
an associated primary path element, then the associated sort element, primary 
path, and path file information are purged as well. 

Sub -commands 


Any one of the following sub-commands can be used: 


CATEGORY - purges the category and all references to it 


CLASS - purges the security class and all references to it 

ELEMENT - purges the data element and all references to it 

FILE - purges the file and all references to it; optionally 
purges related files and associated elements 

GROUP - purges the HP Inform/3000 group and all references to it 


LOCATION - purges the location and all references to it 
PROCEDURE - purges the procedure and all references to it 


Examples 
> PURGE ELEMENT 
ELEMENT> Element] < Identifies element 
to be purged 
DELETE ALL ENTRIES (N/Y)?> Y Confirms request to 
ALL ENTRIES DELETED purge element 
> New command prompt 
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PURGE 


> PURGE FILE 


FILE> Basel < identifies BASE file 
to be purged. 
DELETE ALL ENTRIES(N/Y)?> Y Confirms request to purge 
Basel. 
PURGE RELATED CHILD FILES(Y/N)?> Y Requests tnat all related 
child files be purged. 
PURGE ASSOCIATED ELEMENTS(Y/N)?> Y Requests that child file 


elements not associated 
with another file be 
purged. 

LIST ALL PURGED ENTITIES(Y/N)?> Y Requests that related 
and purged files and 
elements be displayed. 


FILE PURGED: BASE] 


CHILD FILES: FILES PURGED: 
ELEMENTS: ELEMENTS PURGED: 
HP-DIV-MSTR HP-DIV-MSTR 
HP-DIV-NO 
HP-DIV-NAME 
HP - GROUP 
COMMODITY-MSTR COMMODITY -MSTR 


COMMODITY-TYPE 
COMMODITY -NAME 


VENDOR-DETAIL VENDOR-DETAIL 
COMMODITY-TYPE 
C-VEND-NUM C-VEND-NUM 
VEND-NAME 
Q1-RATING Q1-RATING 
Q2-RATING Q2-RATING 
Q3-RATING Q3-RATING 
Q4-RATING Q4-RATING 
> New command prompt. 


4-43 Nov 1982 | 


PURGE 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
PURGE CATEGORY CATEGORY * 


DELETE ALL ENTRIES(N/Y)? 


PURGE CLASS CLASS * 
DELETE ALL ENTRIES(N/Y)? 


PURGE ELEMENT ELEMENT Re: 
DELETE ALL ENTRIES(N/Y)? 


PURGE FILE FILE ~ 
1. if FILE is BASE or VPLS file 


DELETE ALL ENTRIES(N/Y)? 

PURGE RELATED CHILD FILES(Y/N)? (You 
must respond YES, Y, NO, or N; no 
default response occurs. ) 

ANSWER YES OR NO. (issued if response to 
PURGE RELATED CHILD FILES was neither 
Yes nor No) 

PURGE ASSOCIATED ELEMENTS(Y/N)? (issued if 
response to PURGE RELATED CHILD FILES 
was Yes; you must respond YES, Y, 

NO, or N; no default response occurs. ) 

ANSWER YES OR NO. (issued if response to 
PURGE ASSOCIATED ELEMENTS was neither 
Yes nor No) 

LIST ALL PURGED ENTITIES(Y/N)? (issued 
if response to PURGE RELATED CHILD FILES 
or PURGE ASSOCIATED ELEMENTS was Yes) 


Nov 1982 - 4-44 


You enter: 


PURGE GROUP 
PURGE LOCATION 


PURGE PROCEDURE 


Prompts 


PURGE 


You are prompted for: 


2. if FILE is MAST, DETL, AUTO, MPEF, 
KSAM, or FORM file 


DELETE ALL ENTRIES(N/Y)? 
PURGE ASSOCIATED ELEMENTS (Y/N)? 
(You must respond YES, Y, No, 
or N; no default response occurs. ) 
ANSWER YES OR NO. (issued if response to 
PURGE ASSOCIATED ELEMENTS was neither 
Yes nor No) 
LIST ALL PURGED ENTITIES(Y/N)? (issued 
if response to PURGE ASSOCIATED ELEMENTS 
was Yes) 


GROUP 7 
DELETE ALL ENTRIES(N/Y)? 


LOCATION % 
DELETE ALL ENTRIES(N/Y)? 


PROCEDURE * 
DELETE ALL ENTRIES(N/Y)? 


Depending on the sub-command you use, one of the following prompts is issued: 


ANSWER YES OR NO. 


CATEGORY 


CLASS 


DELETE ALL 
ENTRIES (N/Y)? 


ELEMENT 


from the dictionary. 


> Enter "yi : "VES W ; "nN" ; or "NO" ; 


Enter the name of an existing category which is to be 
purged from the dictionary (20 characters). 


Enter the identifying number of an existing security 


class which is to be purged from the dictionary (0 to 


Enter "Y" to purge the entity and all references to it 
Note that typing "N" or pressing 
RETURN in response to this prompt means that no action 


Enter the name of an existing data element which is to 
purged from the dictionary (20 characters). 


4-44a Nov 


is 


be 


1982 





PURGE 


FILE 


GROUP 


LIST ALL PURGED 
ENTITIES (Y/N)? 


LOCATION 
PROCEDURE 


PURGE RELATED 
CHILD 
FILES (Y/N)? 


PURGE ASSOCIATED 
ELEMENTS (Y/N)? 


Nov 1982 


Enter the name of an existing file which is to be purged 
from the dictionary (20 characters). 


Enter the name of an existing HP Inform/3000 group which 
is to be purged from the dictionary (20 characters). 
NOTE: SMENU cannot be purged. 


Enter "Y" or press RETURN to display all related files 
and elements as well as files and elements that were 
purged. Enter "N" if you do not want this listing. 


Enter the name of an existing physical location which is 
to be purged from the dictionary (20 characters). 


Enter the name of an existing procedure which is to be 
purged from the dictionary (20 characters). 


Enter "Y" to purge all related child files and all 
references to these files. Note that a child file is not 
purged if it is related to another parent file. Enter 
"N" to purge only the specified file and all references 
to that file. You must enter YES, Y, NO, or N; no 
default response occurs. 


Enter "Y" to purge all associated (i.e., member) elements 
and all references to these elements. Note that an 
element is not purged if it is associated with other 
files or with other elements. Enter "N" if you do not 
want associated elements purged. You must enter YES, Y, 
NO, or N; no default response occurs. 


4-44b 


RELATE 


Establishes a hierarchical relationship between like entities. 


[option] RELATE sub-command 


REL 





You use the RELATE command to establish a hierarchial relationship between 
entities. The relationship must be between entities of the same type. That 
is, only categories can be related to categories, files to files, and so 
forth. A complete list of entities that can be related is given below under 
Sub-commands. 


The sub-command identifies the type of entity for which a relationship is 
established. For example, if you use RELATE FILE, a relationship between a 
file of type BASE and a file of type MAST, DETL, or AUTO can be established. 
Child entities are ordered within the parent's entry list in the order in 
which they were related-to the parent. This order can be changed through the 
REORDER command. 

Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - relates a category to a category 


ELEMENT - relates a data element to a data element 
FILE - relates a file to a file 
GROUP - relates an HP Inform/3000 group to a group 


PROCEDURE - relates a procedure to a procedure 


RELATE 


Example 


> RELATE FILE 
PARENT FILE> 


CHILD FILE> 
CHILD ALIAS> 
CAPACITY > 
BLOCKMAX > 
DESCRIPTION> 
> 

> 


CHILD FILE> 


ORDMGT < Name of data base. 
CUSTOMER < Data set in data base. 

< Alias will be first 16 
101] < characters of child. 
1024< 
Customer file is a manual master data set in the < 
data base Order Management. « 


< 
RETURN ends prompting for 
< description; another one 
ends command string. 


New command prompt. 


RELATE 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. Two asterisks (**) 
next to a prompt indicate that this prompt and those which follow are 
repeated until RETURN is pressed in response to this prompt. 


You enter: 


COMMAND SUB-COMMAND 


RELATE 


RELATE 


RELATE 


RELATE 


RELATE 


CATEGORY 


ELEMENT 


FILE 


GROUP 


PROCEDURE 


You are prompted for: 


PROMPT 


PARENT CATEGORY = 
CHILD CATEGORY ae 
DESCRIPTION 


PARENT ELEMENT * 
CHILD ELEMENT “x 
BYTE POSITION 


DESCRIPTION 
PARENT FILE ve 
CHILD FILE ad 


CHILD ALIAS 
CAPACITY (issued only if BASE parent file) 
BLOCKMAX (issued only if BASE parent file) 
DESCRIPTION 


PARENT GROUP x 
CHILD GROUP ne 
DESCRIPTION 


PARENT PROCEDURE * 
CHILD PROCEDURE ** 
DESCRIPTION 


RELATE 


Depending on the sub-command you use, one or more of the following prompts is 


Prompts 

issued: 

BLOCKMAX > 
BYTE POSITION > 
CAPACITY > 
CHILD ALIAS > 


CHILD CATEGORY > 


CHILD ELEMENT > 


CHILD FILE > 


CHILD GROUP > 


CHILD PROCEDURE > 


Enter the maximum physical block length (in words) for 
the file within the data base file (128 to 2048). 
DEFAULT is 512. 


Enter a positive integer value for the starting position 
of the child data element field within the parent data 
element field. First byte position is 1. DEFAULT is l. 


Enter an integer value for the maximum number of entries 
for the file within the data base file (0 to 999999999). 
DEFAULT is 0. 


Enter the name by which the child file is known within 
the parent file (16 characters). DEFAULT: If RETURN is 
pressed in response to this prompt, the alias becomes the 
child's file name, up to the first 16 characters. 


Enter the name of an existing category that is the child 
in the relationship (20 characters). 


Enter the name of an existing data element that is the 
child in the relationship (20 characters). 


Enter the name of an existing file that is the child in 
the relationship according to the following restrictions: 


If the parent file is type: 


1. BASE - the child file must be one of the following 
types: 


MAST (IMAGE manual master data set) 
AUTO (IMAGE automatic master data set) 
DETL (IMAGE detail data set) 
2. VPLS - the child file must be the following type: 
FORM (VPLUS form) 


Enter the name of an existing HP Inform/3000 group that 
is the child in the relationship (20 characters). 


Enter the name of an existing procedure that is the child 
in the relationship (20 characters). 


DESCRIPTION 
PARENT CATEGORY 
PARENT ELEMENT 


PARENT FILE 


PARENT GROUP 


PARENT PROCEDURE 


> 


> 


> 


RELATE 


Enter a textual description of the relationship (50 
characters per line, unlimited lines). 


Enter the name of an existing category that is the parent 
in the relationship (20 characters). 


Enter the name of the existing data element that is the 
parent in the relationship (20 characters). 


Enter the name of an existing file (20 characters) that 
is the parent in the relationship. The file type must be 
one of the following: 


BASE (IMAGE data base) 
VPLS (VPLUS forms file) 


Enter the name of an existing HP Inform/3000 group that 

is the parent in the relationship (20 characters). NOTE: 
If the child group is to be related to the highest group 
in the group tree structure, enter "$MENU" as the parent 
group's name. 


Enter the name of an existing procedure that is the 
parent in the relationship (20 characters). 


REMOVE 


Removes a relationship between entities which was established with the RELATE 
command. 


[option] REMOVE sub-command 


REM 





You use the REMOVE command to remove the relationship between entities which 
was established with the RELATE command. You do not purge the entities 
themselves with this command. A complete list of which relationships can be 
removed is given below under Sub-commands. 


The sub-command identifies the type of relationship that is removed. For 
example, if you use REMOVE FILE, you remove the relationship between a parent 
file and a child file. 


Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - removes the relationship between a child and a parent 
category 

ELEMENT - removes the relationship between a child and a parent 
element 

FILE - removes the relationship between a child and a parent 
file 

GROUP - removes the relationship between a child and a parent 


HP Inform/3000 group 
PROCEDURE - removes the relationship between a child and a parent 


procedure 
Example 
>REMOVE FILE 
PARENT FILE> Ordmgt < Name of a data base. 
CHILD FILE> Customer | < Name of a MAST data set 
related to the data base. 
ENTRY DELETED DICTDBM's response. 
CHILD FILE> < RETURN to terminate the 
command. 
> New command prompt. 


Sub-command Prompts 


REMOVE 


For the prompts shown with an asterisk (*), you must enter a response other 


than RETURN in order to implement the command string. 


Two asterisks (**) 


next to a prompt indicate that this prompt and those which follow are 


repeated until RETURN is pressed in response to this prompt. 


You enter: 


COMMAND SUB-COMMAND 


REMOVE 


REMOVE 


REMOVE 


REMOVE 


REMOVE 


CATEGORY 


ELEMENT 


FILE 


GROUP 


PROCEDURE 


You are prompted for: 


PROMPT 


PARENT CATEGORY 


CHILD CATEGORY 


PARENT ELEMENT 
CHILD ELEMENT 


PARENT FILE 
CHILD FILE 


PARENT GROUP 
CHILD GROUP 


PARENT PROCEDURE 
CHILD PROCEDURE 


xx 


** 


*x* 


REMOVE 


Prompts 


Depending on the sub-command you use, one or more of the following prompts is 


issued: 


CHILD CATEGORY > 
CHILD ELEMENT > 
CHILD FILE > 
CHILD GROUP > 
CHILD PROCEDURE > 
PARENT CATEGORY > 
PARENT ELEMENT > 
PARENT FILE > 


PARENT GROUP > 


Enter the name of a child category for which the 
relationship is to be removed (20 characters). 


Enter the name of a child element for which the 
relationship is to be removed (20 characters). 


Enter the name of a child file for which the relationship 
is to be removed (20 characters). 


Enter the name of a child HP Inform/3000 group for which 
the relationship is to be removed (20 characters). 


Enter the name of a child procedure for which the 
relationship is to be removed (20 characters). 


Enter the name of a parent category from which a 
relationship is to be removed (20 characters). 


Enter the name of a parent element from which a 
relationship is to be removed (20 characters). 


Enter the name of a parent file from which a relationship 
is to be removed (20 characters). 


Enter the name of a parent HP Inform/3000 group from 
which a relationship is to be removed (20 characters). 
Enter "SMENU" if the child group is related to the 


highest group in the group tree structure. 


PARENT PROCEDURE > 


Enter the name of a parent procedure from which a 
relationship is to be removed (20 characters). 


RENAME 


Renames an existing entity which was created with the CREATE command. 


[option] RENAME sub-command 


REN 





You use the RENAME command to change the name of an entity. The old name is 
changed everywhere it is referenced in the dictionary to the new name. A 
complete list of which entities can be renamed is given under Sub-commands. 


The sub-command is used to identify the type of entity for which a change is 
to occur. For example, if you use RENAME CLASS, you change the identifying 
number for the specified class. 


Sub-commands 

CATEGORY - renames an existing category 

CLASS - renames an existing identifying number of a security class 
ELEMENT - renames an existing data element 

FILE - renames an existing file 

GROUP - renames an existing HP Inform/3000 group 

LOCATION - renames an existing physical location 

PROCEDURE - renames an existing procedure 


Example 
>RENAME CLASS 
CLASS> 11 < Changes the identifying number 
NEW NUMBER> 111 < from 11 to 1ll. 
> New command prompt. 


RENAME 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
RENAME CATEGORY CATEGORY * 

NEW NAME * 
RENAME CLASS CLASS * 


NEW NUMBER * 


RENAME ELEMENT | ELEMENT * 
NEW NAME * 


RENAME FILE FILE 

NEW NAME 
RENAME GROUP GROUP 

NEW NAME 
RENAME LOCATION LOCATION * 


NEW NAME * 


RENAME PROCEDURE PROCEDURE " 
NEW NAME i 


RENAME 


Prompts 


Depending on the sub-command you use, one or more of the following prompts is 
issued: 


CATEGORY > Enter the name of an existing category (20 characters). 


CLASS > Enter the numeric value which is the identifying number 
of an existing user security class (0 to 9999). 


ELEMENT > Enter the name of an existing data element (20 
characters. 

FILE > Enter the name of an existing file (20 characters). 

GROUP > Enter the name of an existing HP Inform/3000 group (20 


characters). NOTE: $MENU can not be renamed. 


LOCATION > Enter the name of an existing location (20 characters). 
NEW NAME > Enter a new unique name for the entity (20 characters). 
NEW NUMBER > Enter a new unique numeric value for the user security 


class (0 to 9999). 


REORDER 


Reorders an entity within a relationship which was established with the 
RELATE command. 


[option] REORDER sub-command 


REO 





You use the REORDER command to change the position of where a child appears 
within the parent's entry list which was established with the RELATE command. 
A complete list of which entities can be reordered is given below under 
Sub-commands. 


The sub-command identifies the type of relationship for which a reordering is 
to occur. For example, if you use REORDER CATEGORY, you change the position 
of a child category within a parent category's entry list. 


Before using the REORDER command, you can use the SHOW command to determine 
the current position of the child and the name of the child before which it 
is to be placed. If you respond with RETURN to the NEW POSITION prompt of the 
REORDER command, the child is placed at the end of the parent's entry list. 
Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - reorders a child category within a parent 
category's entry list 


ELEMENT -~ reorders a child data element within a parent data 
element's entry list 

FILE - reorders a child file within a parent file's entry list 

GROUP - reorders a child HP Inform/3000 group within a parent 


group's entry list 
PROCEDURE - reorders a child procedure within a parent procedure's 


entry list 
Example 
>REORDER CATEGORY 
PARENT CATEGORY> Director < 
CHILD CATEGORY> Marketing < Category to be reordered. 
NEW POSITION> Manufacturing < New position is before 
this category. 
CHILD CATEGORY> < Terminate the command. 
> New command prompt. 


REORDER 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
REORDER CATEGORY PARENT CATEGORY * 


CHILD CATEGORY ** 
NEW POSITION 


REORDER ELEMENT PARENT ELEMENT * 
CHILD ELEMENT ax 
NEW POSITION 


REORDER FILE PARENT FILE * 
CHILD FILE bas 
NEW POSITION 


REORDER GROUP PARENT GROUP * 
CHILD GROUP -e 
NEW POSITION 


REORDER PROCEDURE PARENT PROCEDURE * 
CHILD PROCEDURE ** 
NEW POSITION 


REORDER 


Prompts 


Depending on which sub-command you use, one or more of the following prompts 


is issued: 


CHILD CATEGORY 


CHILD ELEMENT 


CHILD FILE 


CHILD GROUP 


CHILD PROCEDURE 


NEW POSITION 


PARENT CATEGORY 


PARENT ELEMENT 


PARENT FILE 


PARENT GROUP 


PARENT PROCEDURE 


Enter the name of a child category that is to be 
reordered (20 characters). 


Enter the name of a child data element that is to be 
reordered (20 characters). 


Enter the name of a child file that is to be reordered. 
(20 characters). 


Enter the name of a child HP Inform/3000 group that is to 
be reordered (20 characters). 


Enter the name of a child procedure that is to be 
reordered (20 characters). 


Enter the name of an existing child entity before which 
the reordered child is to be placed. DEFAULT: Pressing 

RETURN in response to this prompt places the reordered 

child at the end of the parent's list. 


Enter the name of an existing category that is the parent 


‘in the relationship (20 characters). 


Enter the name of an existing data element that is the 
parent in the relationship (20 characters). 


Enter the name of an existing file that is the parent in 
the relationship (20 characters). 


Enter the name of an existing HP Inform/3000 group that 
is the parent in the relationship (20 characters). 


Enter the name of an existing procedure that is the 
parent in the relationship (20 characters). 


Reports a sorted listing of data elements. 





R 


[option] REPORT sub-command 


REPORT 


You use the REPORT command to display an alphabetized list of data elements 


owned by an entity or by its children. 


than one entity is listed only once. 


The sub-command identifies the entity to be listed. 
sub-command, only those elements owned by the named user security class are 


listed. 


dictionary are listed. 


Any element that is owned by more 


If you use class as the 


If you use element, however, all the elements defined in the 
If you use category, file, group, or procedure as the 


sub-command and if the name you enter is for a child, you see the elements 
owned by that entity; if the name you enter is a parent, you see all the 
elements for the related child entities. Since parent procedures can also own 
elements, these too are displayed if applicable. 


When you use the PRINT option with the command string, descriptive 
information is printed in addition to the information normally displayed on 
the terminal. The description information is the description that was entered 
when the entity was created or when an association was made. 


Sub-commands 


Any one of the following sub-commands can be used: 


all the 
related 
all the 
all the 
all the 
related 
all the 


data elements associated 
child categories 

data elements associated 
data elements defined in 
data elements associated 
child files 

data elements associated 


group or with related child groups 


CATEGORY - reports 
or with 
CLASS - reports 
ELEMENT - reports 
FILE ~ reports 
or with 
GROUP - reports 
PROCEDURE - 


reports all the data elements associated 


with a category 

with a security class 
the dictionary 

with a file 

with an HP Inform/3000 


with a procedure 


or with related child procedures, including any owned 
by the named procedure 


REPORT 


Example 


> REPEAT REPORT FILE 
FILE> product < 
LIST OF DATA ELEMENTS UNDER FILE: PRODUCT 


ELEMENT(PRIMARY): TYPE: SIZE: DEC: LENGTH: COUNT: 
DESCRIPTION | X 30 0 30 ] 
PROD-NO U 8 0 8 ] 

FILE> sales < 

LIST OF DATA ELEMENTS UNDER FILE: SALES 

ELEMENT (PRIMARY): TYPE: SIZE: DEC: LENGTH: COUNT: 
ACCOUNT X 10 0 10 ] 
DELIV-DATE X 6 0 6 ] 
DESCRIPTION X 30 0 30 1 
PRICE P 1] 0 6 1 
PROD-NO U 8 0 8 ] 
PURCH-DATE X 6 0 6 ] 
PURCH-NO U 6 0 6 ] 
QUANTITY P 7 0 4 ] 
TOTAL P 1] 0 6 ] 

FILE> customer < 


LIST OF DATA ELEMENTS UNDER FILE: CUSTOMER 


ELEMENT (PRIMARY) : TYPE: SIZE: DEC: LENGTH: COUNT: 


ACCOUNT X 10 0 10 ! 
CITY -NAME X 14 0 14 l 
CREDIT U 2 0 2 l 
DELIV-DATE X 6 0 6 1 
DESCRIPTION X 30 0 30 1 
FIRST-NAME U 18 0 18 ] 
LAST -NAME X 20 0 20 ] 
PRICE P 1] 0 6 1 
PROD-NO U 8 0 8 ] 
PURCH-DATE X 6 0 6 1 
PURCH-NO U 6 0 6 1 
STATE X Z 0 2 l 
STR-ADDRESS X 22 0 22 1 
TOTAL P 11 0 6 ] 
ZIP X 10 0 10 l 
FILE> < RETURN key pressed. 


Sub-command Prompts 


REPORT 


For the prompts shown with an asterisk, you must enter a response other than 


RETURN in order to implememt the command string. 


You enter: 


COMMAND SUB-COMMAND 


REPORT 


REPORT 


REPORT 


REPORT 


REPORT 


REPORT 


CATEGORY 


CLASS 


ELEMENT 


FILE 


GROUP 


PROCEDURE 


You are prompted for: 


PROMPT 


CATEGORY * 
CLASS = 


(No prompts) 


FILE * 
GROUP * 
PROCEDURE * 


REPORT 


Prompts 


Depending on the sub-command you use, one of the following prompts is issued: 


CATEGORY > 


CLASS > 


FILE > 


GROUP > 


PROCEDURE > 


Enter the name of an existing 


Enter the numeric value which 
of an existing security class 


Enter the name of an existing 


Enter the name of an existing 


characters). 


Enter the name of an existing 


category (20 characters). 


is the identifying number 
(O to 9999). 


file (20 characters). 


HP Inform/3000 group (20 


procedure (20 characters). 


RESEQUENCE 


Resequences a data element within an association established with the ADD 
command. 


[option] RESEQUENCE sub-command 


RES 





You use the RESEQUENCE command to change a data element's position within the 
list of associations established with the ADD command for an entity. A 
complete list of entities for which data elements can be resequenced is given 
below under Sub-commands. 


The sub-command identifies the type of entity for which a resequencing is to 
occur. For example, if you use RESEQUENCE FILE, you change the position of a 
data element in the list of elements associated with the file. 


The name of the element before which the resequenced element is to be placed 
is entered in response to the NEW POSITION prompt. Pressing RETURN in 
response to this prompt places the resequenced element at the end of the 
association list. 


To see the current list of associations and current positions, use the SHOW 
command. 


Sub-commands 
Any one of the following sub-commands can be used: 


CATEGORY - resequences a data element within a category 

CLASS - resequences a data element within a security class 

FILE - resequences a data element within a file 

GROUP - resequences a data element within an HP Inform/3000 group 
PROCEDURE - resequences a data element within a procedure 


Example 
>RESEQUENCE FILE 
FILE> Customer < The file's name. 
ELEMENT> Last-name < Element to be resequenced. 
NEW POSITION> Street-addr < New position is before 
this element. 

ELEMENT > RETURN to terminate command. 

> New command prompt. 
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Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. Two asterisks (**) 
next to a prompt indicate that this prompt and those which follow are 
repeated until RETURN is pressed in response to this prompt. 


You enter: You are prompted for: 
COMMAND SUB-COMMAND PROMPT 
RESEQUENCE CATEGORY CATEGORY * 


ELEMENT mee 
NEW POSITION 


RESEQUENCE CLASS CLASS = 
ELEMENT x 
NEW POSITION 


RESEQUENCE FILE FILE * 
ELEMENT oe 
NEW POSITION 


RESEQUENCE GROUP GROUP * 
ELEMENT “x 
NEW POSITION 


RESEQUENCE PROCEDURE PROCEDURE s 
ELEMENT sas 
NEW POSITION 


RESEQUENCE 


Depending on the sub-command you use, one or more of the following prompts is 


Prompts 

issued: 

CATEGORY > 
CLASS > 
ELEMENT > 
FILE > 
GROUP > 
NEW POSITION > 
PROCEDURE > 


Enter the name of an existing category in which a data 
element is to be resequenced (20 characters). 


Enter the numeric value which identifies an existing 
security class in which a data element is to be 
resequenced (0 to 9999). 


Enter the name of the existing data element which is to 


‘be repositioned within the association list (20 


characters). 


Enter the name of an existing file in which a data 
element is to be resequenced (20 characters). 


Enter the name of an existing HP Inform/3000 group in 
which a data element is to be resequenced (20 
characters). 


Enter the name of the data element before which the 
resequenced data element is to be placed. DEFAULT: 
Pressing RETURN in response to this prompt places the 
resequenced data element at the end of the association 
list. 


Enter the name of an existing procedure in which a data 
element is to be resequenced (20 characters). 


SECURE 


Secures data elements associated with an IMAGE type file to a security class. 


[option] SECURE sub-command 


SEC 





The SECURE command is used to assign all of the data elements associated with 
an IMAGE type file (BASE, MAST, AUTO, or DETL) to one security class and to 
assign one type of access capability for those data elements. By using this 
command, you avoid adding each individual data element, one at a time, toa 
security class with the ADD CLASS command string. 


After you secure all the data elements to the designated class, you can 
selectively change the security class and capability association for an 
element with the UPDATE command, or selectively delete unwanted associations 
with the DELETE command. 


If a data element has previously been associated with the security class used 


in the secure command, this association will be deleted and the new one, 
which may specify a different type of access capability, created. 


Sub-command 


FILE - secures all data elements in a file to one security class 


Example 
> SECURE FILE 
FILE> Customer < File to be secured. 
CLASS> 1 < Security class identifier. 
ACCESS CAPABILITY> M< Type of access. 
> | New command prompt. 


SECURE 


~Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 


COMMAND SUB-COMMAND PROMPTS 
SECURE FILE | FILE * 
CLASS * 


ACCESS CAPABILITY * 


SECURE 


Prompts 


ACCESS CAPABILITY > Enter the type of access capability given to the user 


CLASS 


FILE 


security class for all the data elements in the above 
named file. Choose from one of the following: 


= read only 

= read and update only 

= read, write and modify 

= null read/write list "(/)" 


“x RaW 
! 


Refer to the IMAGE/3000 Reference Manual for a detailed 
explanation of the meanings of user class access 
capabilities. 


Enter the numeric integer for an existing user security 
class (0 to 9999). 


Enter the name of an existing file (20 characters). The 
type of file must be one of the following: 


BASE = IMAGE data base 

MAST = IMAGE manual master data set 
AUTO = IMAGE automatic master data set 
DETL = IMAGE detail data set 


SHOW 


Shows all the relationships for an entity and the associations for child 
entities. 


[option] SHOW sub-command 


s 





You use the SHOW command to display the hierarchical relationship for an 
entity and the association information for child entities. Relationships are 
established using the RELATE command and associations are established using 
the ADD command. 


The sub-command identifies the entity to be displayed. If you use location or 
class as the sub-command, you see association information. If you use 
category, procedure, file, or group, you see the relationship and the 
association information. For elements, only relationship information is 
displayed. 


The relationship information is displayed as a tree structure from the point 
of entry down. After the parent entity name is displayed, the order that each 
child is displayed in is the order in which the child was related to the 
parent. 


Data elements associated with each child are optionally displayed according 
to your response to the prompt to do so. If you choose to display the data 
elements, an asterisk (*) appearing next to the element indicates that it is 
a key or search element within that file. 


When you use the PRINT option with the command string, descriptive 
information is printed in addition to the information normally displayed on 
the terminal. The description information is the information that was entered 
when the relationship or association was made. 


SHOW 


Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY 


CLASS 


ELEMENT 


FILE 


GROUP 


LOCATION 
PROCEDURE 


shows all the relationships for a category 

plus associated data elements where applicable 

shows all the associations for a user security class 
shows all the relationships for a data element 

shows all the relationships and links for a file 
plus associated data elements where applicable 

shows all the relationships for an HP Inform/3000 group 
plus associated data elements where applicable. and 
access information for the group 

shows all the associations for a location 

shows all the relationships for a procedure 

plus associated data elements where applicable 


SHOW 


Example 


> SHOW FILE 
FILE> HOUSES < 


SHOW ALL FILE ELEMENTS(Y/N)?> y 


FILE: TYPE: RESPONSIBILITY: 
HOUSES BASE 
FILE(ALIAS) : TYPE: FILE(PRIMARY) : CAPACITY: 
CITY-MASTER MAST CITY-MASTER 101 
ELEMENT (ALIAS) : PROPERTIES: ELEMENT (PRIMARY) : 
CITY-ABBR x U (4,0,4) CITY-ABBR 
CITYNAME U (20,0,20) CITYNAME 
FILE(ALIAS) : TYPE: FILE(PRIMARY) : CAPACITY: 
BATH-MASTER AUTO BATH-MASTER 31 
ELEMENT (ALIAS) : PROPERTIES: ELEMENT (PRIMARY) : 
NUMBER-BATHS x X (4,0,4) NUMBER-BATHS 
FILE(ALIAS) - TYPE: FILE(PRIMARY) : CAPACITY: 
BEDS-MASTER AUTO BEDS-MASTER eh 
ELEMENT (ALIAS) : PROPERTIES: ELEMENT (PRIMARY): 
NUMBER -BEDS X (2,0,2) NUMBER-BEDS 
FILE(ALIAS) : TYPE: FILE(PRIMARY): — CAPACITY: 
RESIDENTIAL DETL RESIDENTIAL 200 
ELEMENT (ALIAS) : PROPERTIES: : ELEMENT (PRIMARY) : 
CITY-ABBR * U (4,0,4) CITY-ABBR 
CHAIN MASTER SET: CITY-MASTER 
NUMBER-BEDS x X (2,0,2) NUMBER-BEDS 
CHAIN MASTER SET: BEDS-MASTER 
NUMBER-BATHS * X (4,0,4) NUMBER-BATHS 
CHAIN MASTER SET: BATH-MASTER 
CURRENT-OWNER U (20,0,20) CURRENT-OWNER 
OWNERS-PHONENR X (10,0,10) OWNERS-PHONENR 


SHOW. 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. 


You enter: You are prompted for: 


COMMAND SUB-COMMAND PROMPT 

SHOW CATEGORY CATEGORY * 
SHOW CLASS CLASS 
SHOW ELEMENT ELEMENT sd 
SHOW FILE FILE > 
SHOW GROUP GROUP n 
SHOW LOCATION LOCATION * 
SHOW PROCEDURE PROCEDURE x 


Prompts 


SHOW 


Depending on which sub-command you use, one of the following prompts is 


issued: 


CATEGORY 


CLASS 


ELEMENT 


FILE 


GROUP 


LOCATION 


PROCEDURE 


Enter the name of an existing category for which 
relationships are to be shown (20 characters). 


Enter the name of an existing user security class for 
which a list of associations is to be given (4 
characters). 


Enter the name of an existing data element for which 
relationships are to be shown (20 characters). 


Enter the name of an existing file for which 
relationships are to be shown (20 characters). 


Enter the name of an existing HP Inform/3000 group for 
which relationships and access information are to be 
shown (20 characters). NOTE: A pound sign (#) indicates 
the element will not be displayed on HP Inform/3000's 
Data Names Menu. 


Enter the name of an existing location for which a list 
of associations is to be given (20 characters). 


Enter the name of an existing procedure for which 
relationships are to be shown (20 characters). 


UPDATE 


Updates an association between entities which was established with the ADD 
command. 


[option] UPDATE sub-command 


U 





You use the UPDATE command to change the association for an element, a file, 
or a procedure established with the ADD command. A complete list of entities 
for which an association can be changed is given below under Sub-commands. 


The sub-command identifies the type of entity association that is changed. 
For example, if you use UPDATE CATEGORY, you can change the description of 
the association or the element alias name. 

Sub-commands 


Any one of the following sub-commands can be used: 


CATEGORY - updates 
CLASS - updates 


a data element to a category association 

a data element to a user security class association 
CLASS -FILE - updates a file to a user security class association 
FILE - updates a data element to a file association 
FILE-LOC - updates a file to a location association 
GROUP - updates a data element to an HP Inform/3000 group association 
PROCEDURE - updates a data element to a procedure association 
PROCEDURE-LOC - updates a procedure to a location association 


Example 
> UPDATE CATEGORY 
CATEGORY> Marketing < Category's name. 
ELEMENT> Account < Element to be updated. 
EDIT DESCRIPTION(Y/N)? N No, to edit description 


of the relationship. 
ELEMENT ALIAS: 
ACCOUNT Current alias. 
ELEMENT ALIAS> Account-Marketing < New element alias. 


ELEMENT > RETURN to end the command. 


> New command prompt. 


UPDATE 


Sub-command Prompts 


For the prompts shown with an asterisk (*), you must enter a response other 
than RETURN in order to implement the command string. Two asterisks (**) 
next to a prompt indicate that this prompt and those which follow are 
repeated until RETURN is preassed in response to this prompt. 


You enter: You are prompted for: 

COMMAND SUB-COMMAND PROMPTS 

UPDATE CATEGORY CATEGORY ® 
ELEMENT xx 


EDIT DESCRIPTION (Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 
EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 
ELEMENT ALIAS 


UPDATE CLASS CLASS * 

ELEMENT xk 

EDIT DESCRIPTION(Y/N)? 

EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 

EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 

EDIT DESCRIPTION) 
ACCESS CAPABILITY 


UPDATE CLASS -FILE CLASS * 
FILE ** 
EDIT DESCRIPTION(Y/N)? (not issued if file is 
MPEF, KSAM, or VPLS) 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION or if file is 
MPEF, KSAM, or VPLS) 
EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION ) 
ACCESS CAPABILITY (not issued if file is MPEF, 
KSAM, or VPLS) 


UPDATE FILE FILE * 
ELEMENT x 
EDIT DESCRIPTION(Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 
EDIT ATTRIBUTES (Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 


UPDATE 


Additional prompting occurs as follows: 
1. if file type is MAST 
ELEMENT ALIAS 
NEW KEY ELEMENT(N/Y)? (issued if element is 
not the key) 
2. if file type is AUTO, MPEF, or FORM 
ELEMENT ALIAS 
3. if file type is DETL 
ELEMENT ALIAS 
PATH FILE 
SORT ELEMENT (issued if it is a search 


item) 


next, if element is a search item and 
is currently the primary path, 


CANCEL PRIMARY PATH(N/Y)? 


or, if element is a search item but is 
not currently the primary path, 


PRIMARY PATH(N/Y)? 
4. if file type is KSAM 
ELEMENT ALIAS 


next, if element is currently a 
KSAM key, 


CANCEL KEY(N/Y)? 


or, if element is currently not a 
KSAM key, 


KEY ELEMENT(N/Y)? 


UPDATE FILE-LOC LOCATION = 
FILE xx 
EDIT DESCRIPTION(Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 
EDIT ATTRIBUTES (Y/N)? (issued only if Yes to 


UPDATE GROUP 


UPDATE PROCEDURE 


UPDATE PROCEDURE-LOC 


UPDATE 


EDIT DESCRIPTION) 
FILE SIZE (issued if file type is MPEF or KSAM) 
FILE ALIAS 


GROUP a) 


ELEMENT ux 
EDIT DESCRIPTION (Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 
EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 
ELEMENT ALIAS 
FILE 
PARENT FILE (issued if file belongs to more 
than one data base) 
VALUE AS A LINK 
CHANGE ELEMENT TO DISPLAY(N/Y)? (issued if 
element is currently nondisplay ) 
CHANGE ELEMENT TO NONDISPLAY(N/Y)? (issued 
if element is currently display) 


PROCEDURE = 


ELEMENT ** 
EDIT DESCRIPTION(Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
| EDIT DESCRIPTION) 
EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 
ELEMENT ALIAS 


LOCATION * 


PROCEDURE i 
EDIT DESCRIPTION(Y/N)? 
EDIT COMMAND>> (* and issued only if Yes to 
EDIT DESCRIPTION) 
EDIT ATTRIBUTES(Y/N)? (issued only if Yes to 
EDIT DESCRIPTION) 
PROCEDURE ALIAS 


UPDATE 


Prompts 


Depending on the sub-command used, one or more of the following prompts is 


issued: 


ACCESS CAPABILITY > 


CANCEL KEY(N/Y)? > 


CANCEL PRIMARY 


PATH (N/Y)? > 
CLASS > 
CATEGORY > 


CHANGE ELEMENT TO 
DISPLAY (N/Y)? > 


Enter a new type of capability to be given to the user 
security class for the file or element using one of the 
following: 


If the sub-command is: 
1. CLASS-FILE - enter one of the following: 
= read only 


= read, write, modify 
= null read/write list "(/)" 


“~ = 


2. CLASS - enter one of the following: 


= read only 

= read and update only 

= read, write and modify 

= null read/write list "(/)" 


“~ s Cw 
1 


Refer to the IMAGE/3000 Reference Manual for a detailed 
explanation of the meanings of user class access 
capabilities. 


DEFAULT: Pressing RETURN in response to this prompt 
indicates no change. 


Enter a "Y" if the data element is no longer to be a key 
in the KSAM file. 


Enter a "Y" if the data element is no longer to be the 
primary path. 


Enter a positive numeric value which is the identifying 
number of the existing user security class used in the 
association (0 to 9999), 


Enter the name of an existing category used in the 
association (20 characters). 


Enter "Y" to change the element to a display element. 
This means it will be displayed for reporting on HP 
Inform/3000's Data Names Menu. 


CHANGE ELEMENT TO 
NONDISPLAY(N/Y)? 


EDIT ATTRIBUTES 
(Y/N)? 


EDIT COMMAND>> 


EDIT DESCRIPTION 
(Y/N)? 


ELEMENT 


ELEMENT ALIAS 


FILE 


UPDATE 


> Enter "Y" to change the element to a nondisplay element. 
This means it will not be displayed for reporting on HP 
Inform/3000's Data Names Menu. 


> Enter an "N" to not generate prompts for attributes (see 
Sub-command Prompts for which attributes can be changed). 
> Enter one of the EDIT COMMANDS described in Using Edit 


Description Commands in Section III. 


> Enter an "N" if editing is not to be done for the textual 
description of the association. 


v 


Enter the name of an existing data element used in the 
association (20 characters). 


> Enter the name by which the data element is known within 
the file (15 characters if FORM, 16 if MAST, AUTO, or 
DETL, and 20 if MPEF or KSAM); category (60 characters) ; 
HP Inform/3000 group (20 characters); or procedure (16 
characters). DEFAULT: Pressing RETURN in resonse to this 
prompt indicates no change. 


Note that HP Inform/3000 and Report/3000 will be unable 
to retrieve the values of an element from an IMAGE data 
set if the alias name entered in response to the ELEMENT 
ALIAS prompt of the ADD FILE command string is not the 
same as the actual name of the data element in the data 
set. 


> If the sub-command is: 


1. CLASS-FILE or GROUP - enter the name of a file (20 
characters). The file type must 
be one of the following: 


MAST = IMAGE manual master data set 
AUTO = IMAGE automatic master data set 
DETL = IMAGE detail data set 

KSAM = KSAM file 

MPEF = MPE sequential file 

VPLS = VPLUS forms file 


2. FILE - enter the name of a file (20 characters). The 
file type must be one of the following: 
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UPDATE 


FILE ALIAS 


FILE SIZE 


GROUP 


KEY ELEMENT (N/Y )> 


LOCATION 


NEW KEY ELEMENT 
(N/Y)? 


PARENT FILE 


PATH FILE 


PRIMARY PATH 
(N/Y)? 


PROCEDURE 


> 


MAST - IMAGE manual master data set 
AUTO - IMAGE automatic master data set 
DETL - IMAGE detail data set 

KSAM - KSAM file 

MPEF - MPE sequential file 

FORM - VPLUS form | 


Enter a new name by which the file is to be known within 
the location (8 characters). DEFAULT: Pressing RETURN in 
response to this prompt indicates no change. 


Enter a new value for the number of records of the file 
in the location (0 to 999999999). DEFAULT: Pressing 
RETURN in response to this prompt indicates no change. 


Enter the name of an existing HP Inform/3000 group used 
in the association (20 characters). 


Enter a "Y" if the data element is to become the key 
element in the KSAM file. 


Enter the name of an existing location used in the 
association (20 characters). 


Enter a "Y" if the data element is to become the new key 
item for the MAST file. 


Enter the name of an existing file (20 characters) that 
is the parent of the data base set specified in response 
to the FILE prompt. The file type must be type BASE 
(IMAGE data base). 


Enter the name of an existing file of type MAST or AUTO 
that is the new chain header for a detail set path (20 
characters). A blank value indicates that the data 
element is no longer to be a search item in the DETL 
file. DEFAULT: Pressing RETURN in response to this 
prompt indicates no change. 


Enter a "Y" if the data element is to become the primary 
path. If another data element already exists as the 
primary path, a "Y" response automatically cancels it. 


Enter the name of an existing procedure used in the 
association (20 characters). 


PROCEDURE ALIAS 


SORT ELEMENT 


VALUE AS A LINK 


UPDATE 


> Enter a new name by which the procedure is to be known 


> 


within the location (8 characters). DEFAULT: Pressing 
RETURN in response to this prompt indicates no change. 


Enter the name of an existing data element that is the 
new sort item for a sorted chain (20 characters). This 
prompt is only issued if a path file exists. A blank 
value (pressing the space bar followed by RETURN ) 
indicates that the chain is no longer sorted. 


DEFAULT: Pressing RETURN following this prompt indicates 
no change. 


Enter -1, 0, or a positive integer to specify which 
elements should preferably be used in linking files. The 
numbers indicate the following: 


“1 The element can not be used for linking. 


0) The element may or may not be used for 
linking (DEFAULT). 


1 or greater The element should be used as a link when 
possible; elements assigned a positive link 
value form a prioritized list to be used 
when it is necessary to link files (the 
lower the positive integer, the higher the 
priority). 
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DICTIONARY /3000 
UTILITIES 





OVERVIEW 


The Dictionary/3000 utilities provide a data base administrator with the 
ability to control and easily perform IMAGE data base creation and 
maintenance functions. The maintenance function is largely automated by the 
extensive use of the information in the dictionary. 


Dictionary/3000 provides the following utilities: 


e Data Base Audit - reports on the usage statistics and 
checks the internal linkages of an IMAGE 
data base. 


e Data Base Creation - uses the information iin the dictionary 
to create a schema and root file for 
an IMAGE data base. 


e Data Base Definition - loads the existing definition of an IMAGE data 
base into the dictionary using the root file. 


e Data Base Unload - copies the data entries of an IMAGE data 
base to disc or tape. 


e Data Base Load - loads data entries from tape or disc into the 
IMAGE data base files. 


® Data Dictionary - cleans up data dictionary after several 
Cleanup months of DICTDBM use. 


Initiating the Utilities 


After logging on, you are ready to run any of the Dictionary/3000 utilities. 
The utilities assume that the dictionary exists in the PUB group of your 
log-on account. If the dictionary you wish to use exists in a different MPE 
group and/or account, you must first identify these by issuing a file 
equation before running the utility. The file equation should be as follows: 
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FILE DICT.PUB=DICT.group.account 
You initiate any of the utilities by issuing an MPE RUN command, as follows: 


RUN utility.PUB.SYS 


Changing Output Files 


All of the utilities use the formal file designators DICTOUT and DICTLIST to 
direct the output to your terminal ($STDOUT) and to the line printer 
(SSTDLIST), respectively. You can redirect these output files by entering 
MPE file equations for DICTOUT and DICTLIST prior to running the utility. 


Selecting Defaults 


Whenever a choice between "Y/N" or "N/Y" is given, the value to the left of 
the slash is always assumed (the default choice). If a RETURN is entered as 
the response to the prompt, the default is used. A response other than a 
"y") "N", "YES", "NO", or RETURN is treated as the default. 


Using the Utilities to Restructure a Data Base 


It is possible to make changes to the design of an existing data base by 
using the Dictionary/3000 utilities. The following steps should be performed 
when restructuring a data base: 


1. Run the Data Base Unload utility (DICTDBU) program, copying the existing 
contents of a data base to a disc file or a tape file. 


2. Run the Data Base Maintenance program (DICTDBM) program and make the 
design changes to the data base by using the appropriate commands. 


3. Run the HP DBUTIL utility program, purging the old data base. (See the 
IMAGE/3000 Reference Manual for details on DBUTIL. ) 


4. Run the Data Base Creation utility (DICTDBC) program, creating a new 
schema file and a new root file for the redesigned data base. 


5. Run the HP DBUTIL utility program, creating and initializing the new data 
base. (See the IMAGE/3000 Reference Manual for details on DBUTIL. ) 


6. Run the Data Base Load utility (DICTDBL) program, loading the new data 
base with the contents of the old data base. The Data Base Load utility 
program compares the old schema file with the new schema file and, if 
necessary, transforms the data field formats of the old data base to agree 
with the formats of the new data base. 


Nov 1982 5-2 


Dictionary/3000 Utilities 


DATA BASE AUDIT UTILITY 


The Data Base Audit utility (DICTDBA) provided by Dictionary/3000 is used to 
report on usage statistics and to check linkages for an IMAGE data base. The 
report includes information on synonyms and chains for master sets and chain 
statistics for detail sets - including the integrity of the chains. 


When this utility is executed, two reports are provided - one at your 
terminal and one at the line printer. The terminal report is a summary 
report, while the line printer report includes more detailed information. 


You can choose to audit a data base for synonym information, for chain 
information by search items, or for specific information on chain lengths. 


The following description explains how to execute the DICIDBA utility program 
and gives an explanation of each prompt. 


You execute this utility by entering the following MPE command: 
RUN DICTDBA.PUB.SYS 


After an acknowledgement message, the audit utility prompts you to select the 
type of audit report to be generated as follows: 


RUN MODE (SYNONYMS/CHAINS/ LINKS) > nN 
You can select only one type of report each time you execute this utility me 
program. The following is a description of each report: i\ 


us ot 


SYNONYMS - the report displayed at the terminal shows the master set's 
name, the type of master, the number of entries in the 
master, the capacity of the master, and the usage percentage 
of the master. The line printer report additionally includes 
the number of entries with synonyms, and the shortest and 
longest synonym chain lengths. 


CHAINS - the terminal report includes the same information as the 
SYNONYM report, plus information on each detail set. The line 
printer report includes statistics by search item on the 
number of chains, the shortest and longest chain length, and 
the average chain length. If a broken chain is detected, a 
warning is given. 


LINKS - the terminal report includes the same information as the 
| CHAINS report, plus more specific information for broken 
chains. The line printer report additionally includes 
information on the forward and backward read counts for the 
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search item. In this mode the chain entries are physically 
read to check the integrity of the chains. The report, 
therefore, takes appreciably longer to run in this mode. 


After the prompt, you indicate the type of report by spelling it as shown or 
by using the abbreviated form of first letter only. If you enter RETURN, the 
DICIDBA utility terminates. 


Next, you are prompted to enter information that identifies the data base to 
the audited. The prompts are as follows: 


BASE > 

BASE PASSWORD> 

MODE > 
You enter the name of the data base in response to the BASE prompt, and a 
password that grants read acccess to the entire data base in response to the 
PASSWORD prompt. If an incorrect password is entered, the prompt is 
reissued. Entering RETURN in response to the prompt for BASE terminates the 
utility. 
Your response to the prompt for MODE indicates the access mode to be used to 
open and read the named data base. If RETURN is entered, the data base will 
be accessed in the default mode, which is 5. (See the IMAGE Reference Manual 


for details on “Access Modes". ) 


Next, the utility begins to execute the selected report. Two reports are 
generated - a summary at your terminal and a detail at the line printer. 


The following examples show how to execute the audit utility and briefly 
explain the responses given to the utility prompts. 


Example of SYNONYMS Report 
>RUN DICTDBA.PUB.SYS How to execute the audit utility. 
DICTIONARY/3000 DB AUDITOR HP32244A.01.00 - (C) Hewlett-Packard Co. 1981 


RUN MODE (SYNONYMS/CHAINS/LINKS)> S Select S for SYNONYM run mode. 


BASE> SHPMGT Name of data base to be audited. 
BASE PASSWORD > Password is not displayed; MANAGER 
was used. 
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MODE > RETURN entered; opens data base in 
default access mode 5. 


Terminal report is generated as follows: 

PRODUCT-MASTER M: 22/101 [21%] Set name; set type; current number 
of entries/set capacity; capacity 
usage percentage. 

PO-MASTER A: 0/311 [0%] 

ITEM-MASTER M: 44/311 [14%] 

END OF PROGRAM 


Line printer report is generated as follows: 


RUN MODE: SYNONYMS Identifies run mode selected. 

BASE: SHPMGT.PUB.MARTIN Tdentifies the selected base. 

PRODUCT-MASTER M: 22/101 [21%] Same information as terminal 
report. 


NUMBER OF ENTRIES WITH SYNONYMS: 0 [0%] 
PO-MASTER A: 0/311 [0%] 


SET.IS EMPTY 


ITEM-MASTER M: 44/311 [14%] 
NUMBER OF ENTRIES WITH SYNONYMS: 1 [2%] Detail information on 
SHORTEST SYNONYM CHAIN LENGTH: 1 synonym and chain; 
LONGEST SYNONYM CHAIN LENGTH: | synonym % = (synonym count x 


100)/entry count, in this 
case (1x100)/44 = 2%. 
END OF AUDIT RUN 
Example of CHAINS Report 
“-RUN DICTDBA.PUB.SYS How to execute the utility. 
DICTIONARY/3000 DB AUDITOR HP32244A.01.00 - (C) Hewlett-Packard Co. 198] 


RUN MODE (SYNONYMS/CHAINS/LINKS)> C Select C for CHAINS run mode. 


BASE> SHPMGT Name of base to be audited. 


5-5 Nov 1982 
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BASE PASSWORD> 


MODE > 


Password is not displayed; 
MANAGER was used. 


RETURN entered; opens data base 
in default access mode 5. 


Terminal report is generated as follows: 


PRODUCT-MASTER M: 22/101 [21%] 


PO-MASTER A: 0/311 [0%] 
ITEM-MASTER M: 44/311 [14%] 
EXPLODE D: 397/1023 [38%] 
ITEM-DETAIL D: 0/507 [0%] 
COSTING D: 0/1008 [0%] 


END OF PROGRAM 


Set name; set type; current number 
of entries/set capacity; capacity 
usage percentage. 


DETAIL data set information 
included for CHAINS run mode. 


Line printer report is generated as follows: 


RUN MODE: CHAINS 
BASE: SHPMGT.PUB.MARTIN 


PRODUCT-MASTER M: 22/101 [21%] 


NUMBER OF ENTRIES WITH SYNONYMS: 


PO-MASTER A: 0/311 [0%] 
SET IS EMPTY 


ITEM-MASTER M: 44/311 [14%] 


NUMBER OF ENTRIES WITH SYNONYMS: 
SHORTEST SYNONYM CHAIN LENGTH: 
LONGEST SYNONYM CHAIN LENGTH: 


EXPLODE D: 397/1023 [38%] 


SEARCH ITEM: PRODUCT -NO 


0 


Identifies run mode selected. 
Identifies the selected base. 


Same information as terminal 
report. 


[0%] 


[2%] Synonym chain information 
for master set. 


Information at the search item 
level for detail data set. 
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NUMBER OF CHAINS: 22 Chain information begins. 
SHORTEST CHAIN LENGTH: 18 
LONGEST CHAIN LENGTH: 19 
AVERAGE CHAIN LENGTH: 18 
SEARCH ITEM: ITEM-NO 
NUMBER OF CHAINS: 44 
SHORTEST CHAIN LENGTH: 2 
LONGEST CHAIN LENGTH: 24 
AVERAGE CHAIN LENGTH: 9 
ITEM-DETAIL D: 0/507 [0%] 
SET IS EMPTY 
COSTING D: 0/1008 [0%] 
SET IS EMPTY 


END OF AUDIT RUN 


Example of LINKS Report 

“RUN DICTDBA.PUB.SYS How to execute the audit utility. 
DICTIONARY/3000 DB AUDITOR HP32244A.01.00 - (C) Hewlett-Packard Co. 1981 
RUN MODE (SYNONYMS/CHAINS/LINKS)> L Select mode L for LINKS. 

BASE> SHPMGT Name of base to be sated: 


BASE PASSWORD > Password is not displayed; 
. MANAGER was used. 


MODE > RETURN entered; opens data base 
in default access mode 5. 


Terminal report is generated as follows: 


PRODUCT-MASTER M: 22/101 [21%] Set name; set type; current number 
of entries/set capacity; capacity 
usage percentage. 

PO-MASTER A: 0/311 [0%] 


ITEM-MASTER M: 44/311 [14%] 
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EXPLODE D: 397/1023 [38%] 
ITEM-DETAIL D: 0/507 [0%] 
COSTING D: 0/1008 [0%] 


END OF PROGRAM 


Line printer report is generated as follows: 


RUN MODE: LINKS 
BASE: SHPMGT.PUB.MARTIN 


PRODUCT-MASTER M: 22/101 (21%) 


NUMBER OF ENTRIES WITH SYNONYMS: 


FORWARD SERIAL READ COUNT: 22 
REVERSE SERIAL READ COUNT: 22 


PO-MASTER A: 0/311 (0%) 
SET IS EMPTY 
ITEM-MASTER M: 44/311 (14%) 
NUMBER OF ENTRIES WITH SYNONYMS: 
SHORTEST SYNONYM CHAIN LENGTH: 
LONGEST SYNONYM CHAIN LENGTH: 


FORWARD SERIAL READ COUNT: 44 
REVERSE SERIAL READ COUNT: 44 


EXPLODE D: 397/1023 (38%) 


FORWARD SERIAL READ COUNT: 397 
REVERSE SERIAL READ COUNT: 397 


SEARCH ITEM: PRODUCT-NO 


NUMBER OF CHAINS: 22 
SHORTEST CHAIN LENGTH: 18 
LONGEST CHAIN LENGTH: 19 
AVERAGE CHAIN LENGTH: 18 


FORWARD CAHIN READ COUNT: 397 
REVERSE CHAIN READ COUNT: 397 


0 


| 
1 
| 


Identifies run mode selected. 
Name of base to be audited. 


Same information as terminal 
report. 


(0% ) 


(2%) Synonym information for 
the master set. 


Detail information by search item. 


SEARCH ITEM: ITEM-NO 
NUMBER OF CHAINS: 44 
SHORTEST CHAIN LENGTH: 2 
LONGEST CHAIN LENGTH: 24 
AVERAGE CHAIN LENGTH: 9 


FORWARD CHAIN READ COUNT: 397 
REVERSE CHAIN READ COUNT: 397 


ITEM-DETAIL D: 0/507 (0%) 
SET IS EMPTY 

COSTING D: 0/1008 (0%) 
SET IS EMPTY 


END OF AUDIT RUN 
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Second search item in the set. 
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DATA BASE CREATION UTILITY 


The Data Base Creation utility (DICTDBC) provided by Dictionary/3000 allows 
you to create a schema and a root file for an IMAGE data base. Once these 
are created, you execute the HP utility program DBUTIL to create the data 
base files. The DBUTIL utility program is not explained in this manual. Refer 
to the IMAGE/3000 Reference Manual for detailed information about this 
utility. 


The DICTDBC utility prompts you for information that identifies which data 
base definition in the data dictionary is to be used. It also prompts you to 
enter information that is used by the schema processor when generating a 
schema and a root file. DBSCHEMA is automatically executed for you by the 
utility program. (For details on DBSCHEMA, see the IMAGE/3000 Reference 
Manual. ) 


When DBSCHEMA terminates, this utility terminates. If a schema and a root 
file are created, you can immediately execute DBUTIL to create the data base 
files. This utility does not execute DBUTIL for you. If errors prevent a root 
file from being created, you have to make the corrections in the data 
dictionary before re-executing the DICTDBC utility. 


The following description tells how to execute the DICTDBC utility program 
and gives an explanation of each prompt. 


You execute the DICTDBC utility by entering the following MPE command: 
RUN DICTDBC.PUB.SYS 


After the utility issues an acknowledgement message, you are prompted to 
enter a password as follows: 


DICTIONARY PASSWORD> 


The password that you enter must grant at least PROGRAMMER level access to 
the dictionary. (See Appendix C for an explanation of the levels of access.) 
If you press RETURN in response to this prompt, the utility terminates. 


The password that you enter is not displayed on your terminal. If it is not 
entered correctly, an error message is displayed and the prompt reissued. 


After accepting your password, the utility issues the following prompt: 
BASE > 
You respond to this prompt by entering the name of the data base for which a 


schema and a root file are to be created. A definition for the named data 
base must exist in the data dictionary. If it does not, an error message is 
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displayed and the prompt is reissued. If you press RETURN in response to this 
prompt, the utility terminates. 


Next, you are prompted to enter information to be used by the schema 
processor. The first prompt for processor information is: 


CONTROL LINE> 


The information that may be entered is the same as described in the 
IMAGE/3000 Reference Manual - except for BLOCKMAX. The information is 
repeated here for your convenience and includes an explanation of BLOCKMAX as 
it is defined for this prompt. 


Your response to this prompt can include one or more of the following, 
separated by commas: 


LIST - causes each source record of the schema to be printed on 
the listfile. 


NOLIST - specifies that only source records with errors be 
printed on the listfile. 


ERRORS =nnn - sets the maximum number of errors to nnn. nnn may have 
a value between 0 and 999, inclusive. If more than three 
errors are detected, the Schema Processor terminates. 
The default value is 100. 


LINES =nnnnn - sets the number of lines per page on the listfile nnnnn. 
nnnnn may have a value between 4 and 32767, inclusive. 
The default is 60 if listfile is a line printer and 
32767 if it is not. 


ROOT - causes the Schema Processor to create a root file if no 
errors are detected in the schema. 


NOROOT - prevents the Schema Processor from creating a root file. 


BLOCKMAK=nnnn - sets the maximum physical block length (in words) for a 
data set. If you do not include this parameter, the 
value declared in the data dictionary is used. If you 
entered RETURN to the prompt for BLOCKMAX in the 
dictionary, the default value of 512 is used. Refer to 
the RELATE FILE command string in Section IV for an 
explanation of BLOCKMAX. . 


TABLE - causes the Schema Processor to write a table of summary 
information about the data sets to the listfile device 
if no errors are detected. 
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NOTABLE - suppresses the TABLE option. 


The defaults for the control line options are: LIST, ROOT, and TABLE. 
The utility continues prompting for schema processor information as follows: 
SCHEMA FILE> 


The schema file can be a temporary or a permanent file. To create a process 
temporary file, you press RETURN as your response to this prompt. If the 
schema file is to be a permanent file, enter the name of the file as your 
response. The utility creates the file for you if it is new, or issues a 
warning before over-writing an existing file. 


An output listing of the schema and root file is generated by DBSCHEMA. The 
_ next prompt is used to indicate where that listing is to be sent: 


LIST FILE> 


You can enter one of the following options as your response to this prompt: 


LP - sends the listing to the line printer. 
NULL - suppresses the listing. 
filename - sends the listing to the existing or to a new 


disc file. Before over-writing an existing file, 
you are prompted to approve purging the existing 
file's contents. 


*filename - sends the listing to the file identified in the 
back referenced file equation. 


Pressing RETURN in response to this prompt sends the listing to your 
terminal. 


If you have defined security only for the data items and now want to apply 
that security to the set instead, you can do so by responding "YES" to the 
following prompt: 


APPLY SECURITY JUST TO SET LEVEL(N/Y)?> 


If you respond with an "N" or RETURN, the security you specified for the data 
items is written into the schema file. Otherwise, the utility writes the set 
level security into the schema file. The set level security is derived from 
the class or classes assigned to the set in the data dictionary or, if none 
are specified, it is extrapolated from data item security specifications. 
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After processing your response to the set level security prompt, the utility 
executes the schema processor for you. Regardless of whether a schema and a 
root file are created, the utility terminates after the processor's 
execution. If errors prevent a root file from being created, you will have to 
correct them before re-executing DICTDBC. 


The following example shows how to execute this utility and briefly explains 
the responses to the prompts. 

Example 

‘RUN DICTDBC.PUB.SYS How to execute the utility. 


DICTIONARY/3000 DB CREATOR HP32244A.00.00 - (C) Hewlett-Packard Co. 198] 


DICTIONARY PASSWORD > Data dictionary's password. 

BASE> SHPMGT Name of base to be created. 

CONTROL LINE> RETURN pressed; default used. 

SCHEMA FILE> RETURN pressed; session temporary 
file created. 

LIST FILE> RETURN pressed; listing sent to 
terminal. 


APPLY SECURITY JUST TO SET LEVEL(N/Y)?> RETURN pressed; use item level 
security. 


SCHEMA GENERATION DICTDBC executes for you. 


DBSCHEMA generates the following listing at your terminal: 


DBSCHEMA PROCESSOR 
PAGE | HEWLETT-PACKARD 32215B.02.00 IMAGE/3000: DBSCHEMA 
TUE, AUG 11, 1981, 11:03 AM (C) HEWLETT-PACKARD CO. 1978 


BEGIN DATA BASE SHPMGT ; 


PASSWORDS: 
1 SALESPER ; 
2 RECEIVNG; 
3 BUYER; 
4 MANAGER ; 
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ITEMS : 
BUYER-NO, 
DESCRIPTION, 
ITEM-NO, 
LIST-PRICE, 
PO-NUMBER, 
PRODUCT -NO, 
PURCHASE-COST, 
PURCHASE-DATE, 
PURCHASE -QTY , 
QTY-ALLOCATED, 
QTY -ON-HAND , 
QTY -ON-ORDER, 
QTY-REC, 
REORDER-PT , 
UNIT-COST, 
VENDOR-NO, 


SETS: 


NAME : PRODUCT-MASTER, 


ENTRY: PRODUCT-NO 
DESCRIPTION, 
QTY-ON-HAND , 
QTY-ALLOCATED, 
UNIT-COST, 
LIST-PRICE ; 

CAPACITY: 101; 


NAME : PO-MASTER, 
ENTRY: PO-NUMBER 
CAPACITY: 311; 


NAME : ITEM-MASTER, 

ENTRY: ITEM-NO 
DESCRIPTION, 
QTY-ON-HAND , 
QTY-ON-ORDER, 
QTY-ALLOCATED, 
PURCHASE -COST, 
REORDER-PT ; 

CAPACITY: 311; 


NAME : ITEM-DETAIL, 

ENTRY: ITEM-NO 
VENDOR -NO, 
BUYER-NO; 

CAPACITY: 507; 


MANUAL 
(1), 


MANUAL 
‘eee 


MANUAL 
(3), 


DETAIL 


(/2): 


(/3,4): 
(/3,4); 


(1,2/3,4); 


(1,2/3,4); 


(/3,4); 


(! ITEM-MASTER a 
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NAME : EXPLODE , DETAIL (1,2,3/4); 
ENTRY: ITEM-NO ( ITEM-MASTER yi 
PRODUCT -NO (!PRODUCT-MASTER ); 
CAPACITY: 1023; 
NAME: COSTING, DETAIL (/2,3,4); 
ENTRY: ITEM-NO ( ITEM-MASTER (PURCHASE-DATE  )), 


PURCHASE -DATE , 
PURCHASE -QTY, 


PO-NUMBER (!PO-MASTER ), 
QTY-REC; 

CAPACITY: 1032; 

END . 

DATA SET TYPE FLD PT ENTR MED CAPACITY BLK BLK DISC 
~ NAME CNT CT LGTH REC FAC LGTH SPACE 
PRODUCT-MASTER M 6 l 29 39 101 13 508 36 
PO-MASTER M1 1 2 12 311 42 507 36 
ITEM-MASTER M 7 3 29 49 311 10 = 491 132 
ITEM-DETAIL D 3 | 9 13 507 39 510 56 
EXPLODE D 2 2 8 — «16 1023 3] 498 136 
COSTING D 5 2 13 21 1032 24 506 176 


TOTAL DISC SECTORS INCLUDING ROOT: 583 


NUMBER OF ERROR MESSAGES: 0 


ITEM NAME COUNT: 16 DATA SET COUNT: 6 
ROOT LENGTH: 630 BUFFER LENGTH: 510 TRAILER LENGTH: 256 
ROOT FILE SHPMGT CREATED. Schema and root file created. 


END OF PROGRAM 
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DATA BASE DEFINITION UTILITY 


The Data Base Definition utility (DICIDBD) provided by Dictionary/3000 allows 
you to enter in the data dictionary the definition for an existing IMAGE data 
base. This utility, using the root file, creates entries for the data base, 
the data sets, and the data items. The associations of items to files, and 
the relationships between files is performed for you. 


The one function the utility does not do for you is transfer the existing 
security. You have to execute the Dictionary/3000 Data Base Maintenance 
program (DICTDBM) to create and define the security for the data base. 
Section II of this manual discusses execution of DICTDBM, Section III 
discusses how to define security for a data base, and Section IV describes 
the commands that DICTDBM provides. 


Before the definition of the data base is entered into the dictionary, the 
utility checks the existing entries. If the name you use for the data base 
already exists, the utility issues a message indicating that the name is 
already defined. You are given the option to change the name for your data 
base or to terminate the utility's processing. The utility checks the 
current definitions in the data dictionary to avoid redundant or duplicate 
entries. For data sets and data items, the utility makes the same type of 
checks. 


Whenever you rename because of an existing entry, the new name is the 
"primary" name in the dictionary and the name used in your data base becomes 
the "alias" name in the dictionary. Therefore, you do not have to make 
changes to your data base because of renaming for the dictionary. You will 
have to remember the new names when you use the DICTDBM program. 


The following description explains how to execute the DICTDBD utility program 
and gives an explanation of each prompt. 


You execute this utility by entering the following MPE command: 
RUN DICTDBD.PUB.SYS 


After an acknowledgement message, the utility prompts you to enter a password 
to open and read the dictionary. The prompt is: 


DICTIONARY PASSWORD> 
The password that you enter must grant at least PROGRAMMER level access to 
the dictionary. (See Appendix C for an explanation of the levels of access. ) 


If you press RETURN in response to this prompt, the utility terminates. 


The password that you enter is not displayed on your terminal, but if it is 
not entered correctly, an error message is displayed and the prompt reissued. 
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After accepting the password you entered, the utility prompts you to enter 
specific data base identification information as follows: 


BASE > 
BASE PASSWORD> 
MODE > 


You respond to the prompt for BASE by entering the name of the data base to 
be defined in the dictionary for you. The BASE PASSWORD prompt should grant 
read access to the utility for the named data base. 


The MODE prompt indicates the access mode to be used by the utility to open 
and read the data base. The data base can be opened in any mode. If RETURN 
is entered as the response, the base is opened in the default mode which is 
5. (Refer to the IMAGE/3000 Reference Manual for details on "Access Modes". ) 


The process of transferring the definition of the data base begins after you 
respond to the prompt for MODE. A message "LOADING DATA DICTIONARY" is 
displayed. The utility begins by checking whether the entire definition of 
the data base will fit in the dictionary. If it will not, the following 
prompt is issued: 


ENTIRE DEFINITION OF DATA BASE WILL NOT FIT IN DICTIONARY. 
PROCEED (N/Y)? 


A response of "N" or RETURN terminates the utility. Responding "y" allows 
the utility to continue; however, the utility will issue an error message and 
terminate when any one of the data sets is full. Note that if the entire 
definition of the data base will not fit in your dictionary, you can run 
DICTINIT to re-initialize dictionary with larger capacities specified (see 
Appendix C). 


Next, the utility checks the schema of the named data base with the entries 
in the dictionary. If there are no entries identical to those in your data 
base, the transfer is completed and the DICTDBD utility program is 
terminated. You can immediately execute the DICTDBM program and see the 
transferred data base definition. 


If an entry already exists for the data base name, the following message and 
prompt are issued: 


*XERROR: BASE ALREADY DEFINED IN DATA DICTIONARY 
DO YOU WANT TO LOAD UNDER A DIFFERENT NAME(Y/N)?> 


A response of an "N" terminates the execution of the program. If a "Y" or 
RETURN is entered, the following prompt to rename your data base is issued: 
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NEW BASE NAME> 


The name you enter must be unique - that is, it must not already exist in the 
dictionary. If it does, an error message is displayed and the prompt 
reissued. The utility program terminates if RETURN is entered as your 
response to this prompt. 


Next the ITEMS as listed in the schema are checked. If there are no existing 
dictionary entries, the loading process continues. If an entry already exists 
and is compatible with the item in the data base, the following message and 
prompt are displayed: 


COMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT element 
USE EXISTING DEFINITION(N/Y)?> 


If you enter a "Y", the loading process continues. If you enter an "N" or 
RETURN, you are prompted to rename the element as follows: 


NEW PRIMARY ELEMENT NAME> 


A unique name for the element must be entered. The name for the item in your 
data base becomes the alias name for the item in the dictionary. If you 
enter RETURN, the program does not load the element into the dictionary and 
issues the following warning: 


WARNING: ELEMENT HAS NOT BEEN LOADED INTO DICTIONARY 


Then the loading process continues. Each time an existing compatible entry is 
encountered, the above sequence occurs. If an incompatible item is 
encountered, the following sequence occurs: 


INCOMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT element 
NEW PRIMARY ELEMENT NAME> 


You must enter a unique element name in response to the prompt. If you enter 
RETURN, the program does not load the element into the dictionary and issues 
a warning message. 


After checking the data items, the utility compares the data set definitions 
with existing dictionary entries. The definition of a data set includes the 
data items within the set. If there are no other identical entries, the 
transfer is completed and the program terminates. 


If an identical entry for the data set exists, the following message and 
prompt are issued: 


DEFINITION ALREADY IN DICTIONARY FOR SET set 
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USE EXISTING DEFINITION(N/Y)?> 
If you respond with an "N", you are prompted to rename the set as follows: 
NEW PRIMARY FILE NAME> 


A new, unique name, must be entered. By entering "Y" or RETURN, the data set 
is not loaded and a warning message as follows is issued: 


XWARNING: DATA SET HAS NOT BEEN LOADED INTO DICTIONARY 
Each time the program encounters an existing identical definition, the above 
process is repeated. If an existing definition is incompatible, the following 
message and prompt are issued: ; 

DEFINITION ALREADY IN DICTIONARY FOR SET set 

NEW PRIMARY FILE NAME> 


A unique name must be entered for the data set. If RETURN is used, a warning 
is issued. 


The above process continues until the entire schema has been compared with 
existing dictionary entries. When the comparison is complete, the transfer, 
where indicated by your responses to the prompts, is completed. The DICTDBM 
program could be executed to view the transferred definition. 


The following examples show how to execute the Data Base Definition utility 
with a brief explanation of the prompts and responses. 


In the first example, the data base is unique, and no renaming is required. 
The second example shows a data base that is not totally unique and the 
prompts issued by the utility to resolve the definition transfer. 
Example Without Renaming 


RUN DICTDBD.PUB.SYS How to execute this utility. 


DICTIONARY/3000 DB INFO LOADER HP32244A.01.00 - (C) Hewlett-Packard Co. 1981 


DICTIONARY PASSWORD> Password that grants modify 
access used. 

BASE> SHPMGT Name of existing IMAGE data base. | 

BASE PASSWORD > MANAGER is password used. 

MODE > RETURN pressed; default used. 


5-19 
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LOADING DATA DICTIONARY Utility loading definition of 
base into data dictionary. 


END OF PROGRAM 


Example With Renaming 
:RUN DICTDBD .PUB. IMACS How to execute this utility. 


DICTIONARY/3000 DB INFO LOADER HP32244A.01.00 - (C) Hewlett-Packard Co. 198] 


DICTIONARY PASSWORD > Password that grants modify access. 
BASE> SHPMGT Base to be defined in dictionary. 
BASE PASSWORD> MANAGER was used. 

MODE > RETURN pressed; default used. 


LOADING DATA DICTIONARY 

*ERROR: BASE ALREADY DEFINED IN DATA DICTIONARY 

DO YOU WANT TO LOAD UNDER A DIFFERENT NAME (Y/N) ?>Y 

NEW BASE NAME> MYSHPM Will be name of base in dictionary. 
COMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT DESCRIPTION 

DO YOU WANT ELEMENT TO HAVE A DIFFERENT NAME(N/Y)?> RETURN pressed. 
COMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT ITEM-NO 

DO YOU WANT ELEMENT TO HAVE A DIFFERENT NAME(N/Y)?> Y 

NEW PRIMARY ELEMENT NAME> MY-ITEM-NO 
COMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT ‘QTY-REC 

DO YOU WANT ELEMENT TO HAVE A DIFFERENT NAME(N/Y)?> Y | 

NEW PRIMARY ELEMENT NAME > RETURN pressed. 

*WARNING: DATA ELEMENT QTY-REC HAS NOT BEEN LOADED INTO DICTIONARY 
INCOMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR ELEMENT PO-NUMBER 


NEW PRIMARY ELEMENT NAME> RETURN pressed. 
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*WARNING: DATA ELEMENT PO-NUMBER HAS NOT BEEN LOADED INTO DICTIONARY 
DEFINITION ALREADY IN DICTIONARY FOR SET PRODUCT-MASTER 

USE EXISTING DEFINITION(N/Y)?> Y "y" to use existing definition. 
DEFINITION ALREADY IN DICTIONARY FOR SET ITEM-MASTER 

USE EXISTING DEFINITION(N/Y)?> RETURN pressed; existing definition 

not used. 

NEW PRIMARY FILE NAME> PARTS-MASTER 
DEFINITION ALREADY IN DICTIONARY FOR SET EXPLODE 

USE EXISTING DEFINITION(N/Y)?> N 

NEW PRIMARY FILE NAME> RETURN. pressed. 

XWARNING: DATA SET EXPLODE HAS NOT BEEN LOADED INTO DICTIONARY 


INCOMPATIBLE DEFINITION ALREADY IN DICTIONARY FOR SET COSTING 


NEW PRIMARY FILE NAME> MY-COSTING 


END OF PROGRAM 
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DATA BASE UNLOAD UTILITY 


The Data Base Unload utility (DICTDBU) provided by Dictionary/3000 is used to 
unload the contents of an existing IMAGE data base. The data base can be 
unloaded and stored either to a disc file or to a tape file. Additionally, 
the data base can be edited during the unload process. Editing the unload 
process allows you to selectively unload - that is, choose whether or not to 
unload a particular data set. 


When the utility program completes the unloading process, you are provided an 
audit report containing information about the data base unload. 


The following description tells how to execute the DICTDBU utility program 
and gives an explanation of each prompt. 


You execute this utility by entering the following MPE command: 
RUN DICTDBU .PUB.SYS 


After an acknowledgement message, the unload utility issues the following 
prompt to establish a file for the storage of the data base content: 


STORE FILE> 


If the data base is to be stored on disc, enter a file name in response to 
the prompt. The utility builds the file for you if it is a new file. For an 
existing file, the utility issues a warning message and waits for you to 
indicate that it can be overwritten before it continues. 


If the data base is to be stored on tape, enter RETURN in response to the 
STORE FILE prompt. The utility issues the following message: 


TAPE FILE REQUESTED(Y/N) ?> 


If you enter a "Y" or RETURN, a request to mount a tape is issued on the 
system console; otherwise, the prompt for STORE FILE is reissued. If 
necessary, the utility can handle multiple tape reel stores. 


When the utility completes the unloading process, it generates an audit 
report about the unloading process. You specify where the report is to be 
sent by responding to the following prompt: 

LIST FILE> 


You have four options from which to choose for your response to the LIST FILE 
prompt. You can select only one of these options. 
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LP - sends the report to the line printer. If your 
system has no device LP, file equate DICTLIST, 
which defaults to LP. 


NULL - suppresses the audit listing. 


filename - sends the report to the existing 
or to a new disc file. Before over-writing an 
existing file, you are prompted to approve 
purging the existing file's contents. 


* filename - sends the report to the file identified in 
the back-referenced file equation. 


Pressing RETURN in response to this prompt sends the report to your terminal. 


After accepting your response to the prompt for LIST FILE, the utility 
requests the name of the data base to be unloaded with the following prompt: 


BASE > 


Enter the name of the base in response to this prompt. If RETURN is entered, 
an error message is displayed and the program is terminated. Next, you are 
prompted to enter a password as follows: 


BASE PASSWORD > 


In response to this prompt, enter a password that grants read access to the 
named data base. The password is not displayed as you enter it. If the 
password entered is incorrect or does not grant read access to the data base, 
a data base operation error occurs during the unload process. The utility 
issues an error message which tells you why the data base error occurred and 
then terminates. 


To complete the information required, the following prompt is issued: 

MODE > 
Your response to the MODE prompt indicates the access mode to be used to open 
the data base. Any valid access mode is acceptable as a response to this 
prompt. If RETURN is entered, the program uses the default mode, which is 3. 
(Refer to the IMAGE/3000 Reference Manual for details on "Access Modes". ) 


If the data base named in response to the BASE prompt cannot be found, the 
following message is issued after the prompt for access mode: 


XERROR: NO SUCH DATA BASE 


Prompts are then repeated starting with the BASE prompt. 
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Next, prompts pertaining to the unloading process method are issued. The 
first prompt is as follows: 


UNLOAD AUTOMATIC MASTER SETS(N/Y)?> 


If automatic master sets are to be converted into manual master sets, you 
should respond with a "Y"; otherwise, it is unnecessary to unload automatic 
master sets. 


The next prompt identifies how the detail sets are to be unloaded. The 
prompt is as follows: 


UNLOAD DETAIL SETS BY CHAIN(Y/N)?> 


Although it takes longer to unload detail data sets with a chained read, 
improvements in access time of chained reads can be seen after the data base 
is reloaded. Enter "N" as veme response if you do not want to unload the sets 
with a chained read. 


The following prompt allows you to choose which data sets are or are not to 
be unloaded: 


UNLOAD EDIT(N/Y)?> 


You must enter a "Y" to selectively unload the data sets. If you choose to 
selectively unload the data sets, you are prompted as follows: 


set name set type: UNLOAD(Y/N/C/X)?> 


You can choose only one of the unload types. A description of each is as 
follows: 


Y - which is short for YES, specifies that the data set is to be 
unloaded. (This is the default. ) 


N - which is short for NO, specifies that this data set is not to be 
unloaded. 


C - which is short for CONTINUE, specifies that this data set and all 
remaining data sets are to be unloaded: 


X - which is short for EXIT, specifies that this and all remaining data 
sets are not to be unloaded and the program terminates. 


Note that entering a "C" ends the process of unloading data sets with 
"editing", but it does not terminate the program. To terminate the program, 
an "X" must be entered. If RETURN is pressed in response to this prompt, the 
data set is unloaded. 
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If you chose to unload with a chained read and also chose to unload with 
editing, during the editing process you are prompted to enter the search 
item's name for the detail set as follows: 


SEARCH ITEM FOR CHAINED UNLOAD> 


You can enter the name or allow the program to use the default, which is the 
primary path for the detail data set. 


As each data set is unloaded, the program identifies the data set and the 
number of entries unloaded on your terminal screen. When the entire unload 
process is completed, the message "UNLOAD COMPLETED" is displayed, and the 
utility program terminates. An audit report is generated and sent to the file 
you indicated with your response to the LIST FILE prompt. 

The following examples show how to execute the Data Base Unload utility 
program with an explanation of the responses given to the prompts. 

Example 

“RUN DICTDBU.PUB.SYS How to execute this utility. 


DICTIONARY/3000 DB UNLOADER HP32244A.01.00 - (C) Hewlett-Packard Co. 1981 


STORE FILE> TEMPSTOR - Name of a disc file. 

LIST FILE> RETURN sends listing to terminal. 
BASE> HOUSES Name of base to be unloaded. 

BASE PASSWORD> Password used: MANAGER. 

MODE > RETURN pressed; default used. 


UNLOAD AUTOMATIC MASTER SETS(N/Y)?> RETURN pressed. 


UNLOAD DETAIL SETS BY CHAIN(Y/N)?> RETURN pressed. 


UNLOAD EDIT(N/Y)?> Y Unload with editing. 
ZONING-MASTER M: UNLOAD(Y/N/C/X)?> Y Yes, unload this set. 
CITY-MASTER M: UNLOAD(Y/N/C/X)?> Y 

COMMERCIAL D: UNLOAD(Y/N/C/X)?> Cc Unload all remaining sets 


without EDIT prompts. 
SEARCH ITEM FOR CHAINED UNLOAD> ZONING-CODE Identifies the search item 


5-25 


Dictionary/3000 Utilities 


ZONING-MASTER M:6/31 of the detail data set. 
6 ENTRIES UNLOADED IN <1 CPU-SEC Identifies what is unloaded. 
CITY-MASTER M: 20/101 


20 ENTRIES UNLOADED IN <1 CPU-SEC 


LIST-PRICE-MSTR A:42/307 
AUTO NOT UNLOADED 


BATH-MASTER A: 2/31 
AUTO NOT UNLOADED 


BEDS-MASTER A:4/11 
AUTO NOT UNLOADED 


COMMERCIAL D: 10/209 
10 ENTRIES UNLOADED IN <1 CPU-SEC 


RESIDENTIAL D: 40/200 
40 ENTRIES UNLOADED IN <1 CPU-SEC 
UNLOAD COMPLETED 


END OF PROGRAM 
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DATA BASE LOAD UTILITY 


The Data Base Load utility (DICTDBL) provided by Dictionary/3000 is used to 
reload the stored contents of an IMAGE data base. A comparison between the 
old and the new schemas is made before the loading process begins. If changes 
have been made, you are prompted to enter the changed information. 
Additionally, you can selectively reload the data base, that is, you are 
given a choice to load or not to load a particular data set. 


When the utility program completes the loading process, you are provided an 
audit report containing information about the data base load. 


The following description tells how to execute the DICTDBL utility program 
and gives an explanation of each prompt. 


You execute this utility by entering the following MPE command: 
RUN DICTDBL.PUB.SYS 

After an acknowledgement message, the utility program issues: 
STORE FILE> 


If the store file is a disc file, enter the file's name as your response to 
the prompt. An error message is issued if the named file cannot be found and 
the prompt is reissued. If the store file is a tape file, press RETURN as 
your response to this prompt. Before generating a tape request at the system 
console, the utility prompts you as follows: 


TAPE FILE REQUESTED(Y/N)?> 


If you enter a "Y" or RETURN, a request to mount a tape is issued on the 
system console; otherwise, the prompt for STORE FILE is reissued. 


When the utility completes the loading process, it generates an audit report 
of the loading process. You can specify where the report is to be sent with 
the following prompt: 


LIST FILE> 


You have four options from which to choose for your response to the LIST FILE 
prompt: 


LP - sends the audit listing to the line printer; if 


your system has no device LP, file equate 
DICTLIST, which defaults to LP. 
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NULL - suppresses the audit listing. 


filename - sends the audit listing to the existing or to 
a new disc file. Before over-writing an existing 
file, you are prompted to approve purging the 
existing file's contents. 


*filename - sends the listing to the file identified in 
the back referenced equation. 


Pressing RETURN in response to this prompt sends the audit listing to your 
terminal. 


After accepting your response to the prompt for LIST FILE, the utility 
displays the stored data base's name, then prompts you to select a RUN MODE 
for the loading process. The RUN MODE is the operating mode to be used to 
load the data base. The prompt is as follows: 

RUN MODE (LOAD/EDIT/SHOW/EXIT) > 
In response to the prompt, you can choose one of four options: 


LOAD - indicates the named data base is to be loaded. 


EDIT -~ indicates the named data base is to be loaded and 
editing prompts issued for each data set. 


SHOW - indicates the named data base is not to be loaded, but 
the schema and set entry counts are to be displayed. 


EXIT - indicates the utility is to be terminated. 


Pressing RETURN in response to this prompt indicates that the default for RUN 
MODE is used, which is LOAD. 


In an operating mode of LOAD, you are prompted for information only when 
schema changes are encountered. In the EDIT mode, you can select an operating 
mode for the data sets. An operating mode for a data set is similar to the 
operating mode for a data base. 
Next, the utility prompts you to enter the new name for the data base: 

NEW BASE NAME> 
If the name of the stored data base has not changed, including qualifier 
information such as MPE group and account, press RETURN as your response; 


otherwise, enter the new name for the data base. 


If the named data base cannot be found, the following prompt is issued: 
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BASE NOT FOUND> 


This prompt indicates that the identified data base, either from the stored 
file or entered in response to NEW BASE NAME, cannot be found. You should 
re-enter the base name in response to this prompt. If the prompt is reissued, 
terminate the program by entering RETURN and make sure the data base is where 
you think it is. 


When the named data base is found, you are prompted for additional data base 
information as follows: 


BASE PASSWORD> 
MODE > 


The password you enter in response to the password prompt should be one that 
allows modify access to the data base. This password is not displayed as you 
enter it. If the password grants only partial access to the data base, the 
utility will load only those parts of the data base to which it has access; 
no warning is given. If the password is entered incorrectly or does not 
grant modify access, a data base operation error occurs during the loading 
process. The utility issues the following questions if a data base operation 
error occurs: 


DISPLAY INPUT RECORD(Y/N) ?> 
CONTINUE SET LOAD(Y/N)?> 
CONTINUE LOAD PROCESS(Y/N)?> 


You can write the contents of the record to the indicated LIST FILE by 
entering a “Y" or RETURN. 


If you choose to continue the set load, the data entry in error is not 
loaded. If you choose not to continue, the utility allows you to continue 
loading the remaining sets in the data base with the last prompt. 


Your response to MODE indicates the access mode to be used to open the data 
base. Valid responses include 1, 2, 3, 4, and RETURN. Pressing RETURN 
indicates acceptance of the default mode, which is 3. (See the IMAGE/3000 
Reference Manual for "Access Modes". ) 


With the next prompt, you are given the choice to load in a fast I/O mode or 
not. The prompt is: 


FAST I/0(Y/N)?> 


FAST I/O means that the data base buffers are not written at each 
modification. 
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The program begins to load the data base after the FAST I/O prompt. If you 
chose LOAD as the operating mode for the data base, you are prompted only 
when a difference between the old and new schema is encountered. If you chose 
EDIT as the operating mode, the following prompt is issued before the program 
loads each data set: 


SET MODE (LOAD/EDIT/SKIP/CONT/EXIT) > 


You can choose only one of the modes. A description for each is as follows: 


LOAD - indicates that if a difference between the old and new 
schema occurs, issue prompts for the changed 
information. 

EDIT - allows you to change the name of the data set and/or 


data elements during the loading operation. 


SKIP , - allows you to indicate that a data set is not to be 
loaded. 
CONT - cancels the EDIT operation mode for the data base, in 


which case the default of LOAD is used. 
EXIT - indicates the utility program is to be terminated. 


Pressing RETURN in response to this prompt indicates the default of LOAD is 
used. 


When the message LOAD COMPLETED is displayed, the program execution is 
terminated and the audit report is sent to the file indicated with the LIST 
FILE prompt. 


The following examples show how to execute the Data Base Load utility program 
with an explanation of the responses given to the prompts. The examples show 
choosing a data base operating mode of LOAD and of EDIT. The example using an 
operating mode of EDIT also shows choosing a data set operating mode of EDIT 
and of LOAD. The last example shows the audit report generated by the 
utility program for the data base load. 


Example of LOAD Run Mode 
>RUN DICTDBL.PUB.SYS How to execute this utility. 


DICTIONARY/3000 DB LOADER HP32244A.01.00 - (C) Hewlett-Packard Co. 1981] 


STORE FILE> TEMP Name of file containing the 
. contents of the stored base. 
LIST FILE> RETURN sends report to terminal. 


BASE: SHPMGT.PUB.MARTIN 
RUN MODE (LOAD/EDIT/SHOW/EXIT) > LOAD 
NEW BASE NAME> SHPMGT .DEMO 
BASE PASSWORD> 


MODE> | 


PRODUCT-MASTER M 22/101 
PRODUCT-NO - ITEM NOT FOUND, NEW 
22 ENTRIES LOADED IN <1 CPU-SEC 
ITEM-MASTER M 44/211 
44 ENTRIES LOADED IN 1 CPU-SEC 
EXPLODE D 397/1054 
PRODUCT-NO : ITEM NOT FOUND, NEW 


397 ENTRIES LOADED IN 20 CPU-SECS 
LOAD COMPLETED 


END OF PROGRAM 


Example of EDIT Run Mode 
:RUN DICTDBL.PUB.SYS 
DICTIONARY/3000 DB LOADER HP32244A.01. 
STORE FILE> TEMP 
LIST FILE> 

BASE: SHPMGT.PUB.MARTIN 
RUN MODE (LOAD/EDIT/SHOW/EXIT)> EDIT 
NEW BASE NAME> SHPMGT .DEMO 
BASE PASSWORD> 


-MODE> 1 


PRODUCT -MASTER M 22/101 


SET MODE (LOAD/EDIT/SKIP/CONT/EXIT)> EDIT 
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Utility identifies base to load. 

LOAD selected. 

Changing the MPE group for base. 

MANAGER was the password used. 

Opened for shared modify access. 

First data set to be loaded. 

ITEM NAME> PROD-NO LOAD issues 
prompt when old 


and new schemas 
differ. 


ITEM NAME> PROD-NO 


How to execute this utility. 
00 - (C) Hewlett-Packard Co. 198] 
Name of store file. 

RETURN sends report to terminal. 
Program identifies base to load. 
Editing prompts at set level 
requested. 

Loading to a different MPE group. 
MANAGER is password used. 

Opened for shared modify access. 


First data set to be loaded. 
Set level editing capability. 
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PRODUCT-MASTER : NEW SET NAME> If the data set and/or items 
PRODUCT -NO - NEW ITEM NAME> PROD-NO have new names, enter new 
DESCRIPTION >: NEW ITEM NAME> name after prompt as for 

QTY -ON-HAND > NEW ITEM NAME> PROD-NO. 

QTY-ALLOCATED : NEW ITEM NAME> 

UNIT-COST : NEW ITEM NAME> 

LIST-PRICE >: NEW ITEM NAME> 


22 ENTRIES LOADED IN <1] CPU-SEC 


ITEM-MASTER M 44/311 Next data set to be loaded. 
SET MODE(LOAD/EDIT/SKIP/CONT/EXIT)> LOAD No editing prompts generated 
44 ENTRIES LOADED IN 1 CPU-SEC by choosing LOAD. 
EXPLODE D 397/1023 Next data set to be loaded. 
SET MODE (LOAD/EDIT/SKIP/CONT/EXIT)> LOAD | 
PRODUCT -NO - ITEM NOT FOUND, NEW ITEM NAME> PROD-NO LOAD causes 
397 ENTRIES LOADED IN 20 CPU-SECS prompts when 
old and new 
LOAD COMPLETED schemas differ. 


END OF PROGRAM 


Example of Audit Listing 


DICTDBL (A.01.00): TUES, AUG 10, 1981, 1:48 PM DATA BASE LOAD FROM STORE 
FILE TEMP.PUB.MARTIN 


BASE: SHPMGT.PUB.MARTIN 
LOADED TO: SHPMGT.DEMO.MARTIN 


PRODUCT -MASTER M 22/101 
ITEM PRODUCT -NO LOADED TO PROD-NO 
22 ENTRIES LOADED IN <1] CPU-SEC 


ITEM-MASTER M 44/311 
44 ENTRIES LOADED IN 1 CPU-SEC 


EXPLODE D 397/1023 
ITEM PRODUCT-NO LOADED TO PROD-NO 
397 ENTRIES LOADED IN 19 CPU-SECS 


LOAD COMPLETED 
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DICTIONARY CLEAN UTILITY 


As a byproduct of DICTDBM use, a data dictionary slowly accumulates 
superfluous information. This information can be periodically purged by 
using the Dictionary Clean Utility (DICTDBM,UTIL). 


This utility, which can only be executed by the dictionary creator, should be 
run when: 


@ DICTDBM has been used heavily for about 6 months, or 
e the following message appears after signing onto DICTDBM: 
XINFO: DICTIONARY INTERNAL CLEANUP NEEDED (DICT 75) 


To preserve the integrity of your dictionary, ensure that this utility is 
only used on the entire data dictionary, i.e., the root file and ali data 
sets. 


Before executing this utility, back up the data dictionary. Also ensure that 
the temporary file used by DICTDBM,UTIL (DICTTEMP) is large enough to 
accommodate your data. By default, DICTTEMP holds 10,000 records (divided 
into 30 extents). These records originate from three data sets: 
DESCRIPTION-TEXT, FILE-PATH, and FILE-SORT. Run DICTDBA to determine the 
total number of records in these data sets. If the total is >10,000, use the 
FILE command to allocate adequate space, e.g., :FILE DICTTEMP; DISC = your 
value. 


Execute DICTDBM,UTIL by entering the following MPE command: 
>RUN DICTDBM.PUB.SYS UTIL 
The utility issues the following message and prompt: 


DICTIONARY SHOULD BE STORED OFF BEFORE RUNNING THIS UTILITY. 
CONTINUE (Y/N)?> 


Enter Y (to initiate cleanup) or N (to terminate utility execution). When 


the utility has finished processing, the message END OF PROGRAM is displayed 
and the program terminates. 
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Example 

>RUN DICTDBM.PUB.SYS, UTIL How to execute this utility. 
DICTIONARY/3000 CLEAN UTILITY HP32244A.00.03 - (C) Hewlett-Packard Co. 1982 
DICTIONARY SHOULD BE STORED OFF BEFORE RUNNING THIS UTILITY. 

CONTINUE (Y/N)?> Y Must respond "Y" or "N"; 


no default response occurs. 
END OF PROGRAM 
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DICTDBM generates two types of messages on the user terminal - Error Messages 
and Information Messages. Information Messages are conditions that DICTDBM 
informs the user about, but are not errors. Both kinds of messages are found 
in this appendix or in the appropriate reference manual for the indicated 
subsystem. 


Error Messages have the following format: 


XERROR: error-message (error-info) 


Information Messages have the following format: 


XINFO: error-message (error-info) 


In both cases, error-info contains two fields: 


(error-type error-number) 


Error-type is one the following: 


USER - The error is caused by a user of DICTDBM and may usually be 
corrected by entering a different response. 


PROG - The error is due to an error in DICTDBM's environment and may 
usually be corrected by the Systems Engineer. 


SYSTEM - The error is due to constraints of the system DICTDBM is 
running on and may be corrected by the operator. 


TRAP - The error is due to an internal error in DICTDBM and its 
occurrance should be called to the attention of the Systems 
Engineer. 

DICT - The error is caused by the user and may usually be ccrrected 


by entering a different response. These are errors that help 
maintain the integrity of the dictionary. . 
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IMAGE - The error is an IMAGE data base error. Consult the 
IMAGE/3000 Reference Manual. 


MPEF - The error is an MPE file system error. Consult the MPE 3000 
System Error Messages and Recovery Reference Manual. 


Error-number is the number listed in this manual for types USER, PROG, 
SYSTEM, TRAP or DICT, and is a number meaningful to either the IMAGE data 
base system or the MPE file system for types IMAGE or MPEF. 


USER MESSAGES 


MESSAGE 


ENTRY NOT NUMERIC 


INPUT FIELD LONGER 
THAN 72 


ORIGINAL RECORD HAS 
BEEN RESTORED 


NUMERIC INTEGER PART 
LONGER THAN n 


NUMERIC DECIMAL PART 
LONGER THAN n 


MISSING COMMAND 


INVALID COMMAND/ 
OPTION: 
command/option 


INVALID/MISSING 
SUB-COMMAND: 
sub-command 


ENTRY CANNOT BE 
NEGATIVE 


CONNECTOR MUST BE 
ONE OF 'AND', 'OR' 
OR 'TO' 


OPERATOR MUST BE ONE 
OF “EO",) "NE; “EE, 
(Gee *E) OR GT! 


UNDELIMITED TEXT 
STRING 
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EXPLANATION AND/OR ACTION 


Data item type is integer, floating point, or 
numeric ASCII and a non-numeric character has 
been detected in the data entry field. 


Length of data entry exceeds the size ("n") 
defined for the associated data item. 


An error has occurred on updating an entry in a 
data set and the original entry has been 
restored. 


Integer part of a decimal number exceeds the 
length ("n") defined for the associated data 
item. 


Decimal part of a decimal number exceeds the 
length ("n") defined for the associated data 
item. 


A command option was entered without a command. 


The command or command option entered is not 
valid. 


The sub-command entered is not valid for the 
command specified. . 


This item has been declared to always be 
positive. 
Connector must be ‘and, 'or' or ‘to'. 


Operator must be one of 'eg', 'ne', ‘le', 
‘1t' or ‘gt’. 


‘ge' , 


A string value must terminate with a quote. 





DICTDBM Error Messages 


PROG MESSAGES 


MESSAGE | 


EXCEEDED MAXIMUM 
TREE DEPTH 


INCOMPATIBLE CODE 
FILE 


INSUFFICIENT STACK 
FOR WORK SPACE 
RELOAD 


INSUFFICIENT STACK 
FOR SYSTEM LOAD 


EXPLANATION AND/OR ACTION 


Recursive code has gone through too many 
performs to trace tree structure. Reduce the 
depth of the parent/child tree. 


The IPDIC.PUB code file is not compatible with 
the version of DICTDBM currently executing. 


DICTDBM needs more data stack for a work space 
reorganization. Run DICTDBM with a MAXDATA 
greater than 25,000. 


The data stack required for the program is 
greater than the maximum specified for DICTDBM. 
Increase the stack size by specifying a MAXDATA 
on the run command that is greater than the 
default of 25,000. 





SYSTEM MESSAGES 


MESSAGE 


SORT INITIALIZATION 


SORT FILE WRITE 


SORT OUTPUT 


SORT END 


CANNOT OPEN PRINT 
FILE 


CODE FILE READ 


DISC SPACE NOT 


AVAILABLE FOR 


SORT FILE 


PRINT FILE ACCESS 
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EXPLANATION AND/OR ACTION 


Error in call to System SORT Utility. The 
probable cause is insufficient disc space for 
SORT scratch file. 


Error on releasing record to the System SORT 
Utility. If cause is not apparent to the 
resident System Programmer then contact the 


Systems Engineer. 


Error on requesting record from System SORT 
Utility. If cause is not apparent to the 
resident System Programmer then contact the 
Systems Engineer. 


Error in System SORT Utility during exit 
procedures. If cause is not apparent to the 
resident System Programmer then contact the | 
Systems Engineer. 


DICTDBM is unable to open the print file. 


DICTDBM detected a read error while reading the 
code file. 


Could not create scratch space for SORT 
operation. 


The print device is unavailable. Check file 
equate or call the system operator. 
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TRAP MESSAGES 


MESSAGE 


WORKSPACE EMPTY 


EMPTY CODE FILE 


UNEXPECTED EOF IN 
CODE FILE 


ARITHMETIC 
CONVERSION FOR 
TABLE LITERAL 


BROKEN WORK SPACE 
CHAIN 


OUT OF RANGE PCODE 
ADDRESS 


DISPLAY FORMAT 
LEVEL OVERFLOW 


DISPLAY FORMAT 
LEVEL UNDERFLOW 


EXPLANATION AND/OR ACTION 


Internal DICTDBM work space is empty. Please 
notify Systems Engineer. 


DICTDBM detected an empty code file. 


DICTIDBM encountered an unexpected end-of-file 
while reading the code file. Please notify the 
Systems Engineer. 


A program constant cannot be converted to the 
binary equivalent as the current statement 
requires. 


DICTDBM has detected a break in a work space 
link list. Please report the error condition 
to the Systems Engineer. 


DICIDBM has detected an arithmetic trap 
condition in its internal processing. Please 
report the error condition and the internal 
address (given as %9.%99999) to the Systems 
Engineer. 


DICTDBM has detected a PCODE address out of the 
loaded range of transaction codes. Please 
report the error condition and the PCODE 
address (given as %999.%99999) to the Systems 
Engineer. 


DICTDBM has detected an overflow in managing 
format levels. Please report the error 
condition to the Systems Engineer. 


DICTDBM has detected an underflow in managing 
format levels. Please report the error 
condition to the Systems Engineer. 
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DICT MESSAGES 


MESSAGE EXPLANATION AND/OR ACTION 


CONFLICTING LINE Error messages of type DICT are usually due to 
NUMBER SEQUENCE an incorrect response to a prompt. After the 

. message is issued, the prompt is reissued, 
INVALID EDIT allowing the user to respond to the prompt 
COMMAND ,TRY 'HELP' differently. 


NO DESCRIPTION 
LINES EXIST 


DUPLICATE ENTRY 


AUTO SET ALREADY 
HAS A KEY ELEMENT 


FILE TYPE MUST BE 
'MAST' OR 'AUTO' 


SORT ELEMENT TYPE 
MUST BE 'x', 'U' 
OR 'K' 

CANNOT ADD AN 
ELEMENT TO A FILE 
OF TYPE type 


CANNOT ADD ELEMENTS 
TO A PARENT 


CANNOT ADD TO 'SMENU' 


CAPABILITY MUST BE 
RY 8 laa 'M', OR 'x! 


CANNOT ADD SECURITY 
TO FILE TYPE type 


CAPABILITY MUST BE 
'R', tw! OR ae, 


CANNOT USE FILE TYPE 
type 


STORAGE LENGTH CANNOT 
BE ZERO 
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DICT MESSAGES (continued) 


MESSAGE EXPLANATION AND/OR ACTION 


TYPE MUST BE ONE OF: Error messages of type DICT are usually due to 

EE ee oh Ps an incorrect response to a prompt. After the 

ad gg Ry: OR message is issued, the prompt is reissued, 

io ag allowing the user to respond to the prompt 
differently. 


SIZE CANNOT BE ZERO 


DECIMAL LENGTH MUST 
BE LESS THAN SIZE 


SIZE TOO LARGE FOR 
ELEMENT TYPE 


CAN ONLY RESTRICT TO 
A TYPE 'BASE' FILE 


CANNOT PURGE 'SMENU' 


CHILD LARGER THAN 
PARENT 


CHILD FIELD NOT FULLY 
WITHIN PARENT 


RELATIONSHIP NOT 
GENERATED - LOOP 
FOUND IN STRUCTURE 


CHILD FILE MUST BE 
TYPE 'MAST', 'AUTO' 
OR 'DETL' 


CHILD FILE MUST BE. 
TYPE 'FORM' 


PARENT FILE MUST BE 
TYPE 'BASE' OR 'VPLS' 


BLOCKMAX MUST BE 
BETWEEN 128 AND 2048 


CANNOT BE A PARENT IF 
OWN ELEMENTS 
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MESSAGE 


CANNOT RELATE 'S$MENU' 
AS A CHILD 


CANNOT SECURE A FILE 
OF TYPE type 


CHILD ELEMENT NOT 
FOUND 


CHILD FILE NOT FOUND 


CHILD PROCEDURE NOT 
FOUND 


CHILD CATEGORY NOT 
FOUND 


CHILD GROUP NOT FOUND 
TYPE MUST BE ONE OF 
'BASE','MAST','AUTO', 
'DETL','KSAM','MPEF', 
'VPLS', OR 'FORM' 
CANNOT MODIFY '$MENU' 
CATEGORY NOT A PARENT 
ELEMENT NOT A PARENT 
FILE NOT A PARENT 
GROUP NOT A PARENT 


PROCEDURE NOT A PARENT 


CATEGORY CONTAINS NO 
ELEMENTS 


CLASS CONTAINS NO 
ELEMENTS 
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EXPLANATION AND/OR ACTION 


Error messages of type DICT are usually due to 
an incorrectly response to a prompt. After the 
message is issued, the prompt is reissued, 
allowing the user to respond to the prompt 
differently. 
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DICT MESSAGES (continued) 


NO. MESSAGE EXPLANATION AND/OR ACTION 






































46 FILE CONTAINS NO Error messages of type DICT are usually due to 
ELEMENTS an incorrect response to a prompt. After the 
message is issued, the prompt is reissued, 
47 GROUP CONTAINS NO allowing the user to respond to the prompt 
ELEMENTS differently. 


PROCEDURE CONTAINS NO 
ELEMENTS 





ELEMENT NOT IN FILE 





CANNOT UPDATE FILE 
TYPE type 





ELEMENT NOT IN 
PROCEDURE 





ELEMENT NOT IN 
CATEGORY 


ELEMENT NOT IN GROUP 


ELEMENT NOT IN CLASS 


FILE NOT IN CLASS 


FILE NOT IN LOCATION 





PROCEDURE NOT IN 
LOCATION 


LINE NUMBER DOES NOT 
EXIST 


CANNOT RENAME ‘'$MENU' 


NO PARENT FILE EXISTS 
FOR file 


RESPONSE REQUIRED TO 
PROMPT 


DICTDBM Error Messages 


DICT MESSAGES (continued) 


MESSAGE EXPLANATION AND/OR ACTION 


FILE IS NOT A PARENT Error messages of type DICT are usually due to 

OF file an incorrect response to a prompt. After the 
message is issued, the prompt is reissued, 

STORAGE LENGTH MUST allowing the user to respond to the prompt 

BE EVEN FOR IMAGE differently. 



































INSUFFICIENT 
CAPABILITY 

MUST BE ONE OF 'Y', 
'YES','N','NO', OR 
<CR> 


SEARCH ITEM CANNOT BE 
ITS OWN SORT ITEM 


LENGTH MUST BE ONE OF 
2, 4, 8, OR 12 





LENGTH MUST BE LESS 
THAN 15 


LENGTH MUST BE LESS 
THAN 28 





LENGTH MUST BE ONE OF 
4 OR 8 


NEW LENGTH TOO SMALL 
FOR CHILD: element 


NEW LENGTH TOO LARGE 
FOR PARENT: element 





LINK VALUE MUST BE 
GREATER THAN -2 












REPEAT OPTION INVALID 
WITH THIS COMMAND 
STRING 







DICTIONARY INTERNAL Creator of data dictionary should run 
CLEANUP NEEDED DICTDBM.PUB.SYS ,UTIL. 
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UTILITY 
ERROR MESSAGES 


The Dictionary/3000 utility programs generate five types of messages on the 
user terminal. Each type of message is found in this appendix or in the 
appropriate reference manual for the indicated subsystem. The types of 
messages are: : 


1. Errors 
XERROR: error-message 
Errors are conditions that arise out of a user response or some 
operation during the utility process. A correct response or remedy 
for the error condition is required. 

2. IMAGE errors 
XIMAGE ERROR: error-message 
IMAGE errors occur when a call to the IMAGE data base management 
system cannot be performed. The error message returned by IMAGE is 
displayed. Refer to the IMAGE/3000 Reference Manual for more 
information. 

3. File errors 
XFILE ERROR: error-message 
File errors occur when a call to the MPE file system cannot be 
performed. The error message returned by the file system is 
displayed. Refer to the MPE 3000 Error Messages and Recovery 
Reference Manual for more information. 

4. Warnings 


XWARNING: message 


Warning messages are conditions that the utility program informs 
the user about. They are not fatal to the utility process. 


Utility Error Messages 


5. Condition prompts 
condition message> 
Condition prompts inform the user of a certain situation that 


requires a decision by the user. The usual response is "Y" for yes, 
or "N" for no. 


Utility Error Messages 


DICTDBA MESSAGES 


Errors 
MESSAGE EXPLANATION AND/OR ACTION 
BASE NAME TOO LONG Data base name, including qualifiers, 


is greater than 24 characters. 


DATA BASE OPERATION A data base error occurred when 
reading information. An IMAGE 
"DBEXPLAIN message block" is issued 
to explain the error condition. 


INVALID MODE Response to MODE prompt is a number 
other than 1 through 8. 


INVALID RUN MODE An incorrect response to RUN MODE 
prompt entered. 


LIST FILE OPERATION An error occurred during writing 
the list file (DICTLIST). 


PASSWORD LONGER THAN 8 Response to BASE PASSWORD prompt 
CHARACTERS is greater than 8 characters. 


LIST FILE OPEN Device LP is not available. File 
equate DICTLIST, which defaults to 
LP. 
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Utility Error Messages 


DICTDBA MESSAGES (continued) 


Warnings 
MESSAGE EXPLANATION AND/OR ACTION 
BROKEN CHAINS A broken chain has been encountered 





in a detail set. The data base 

should be unloaded serially with 
DICTDBU and then reloaded with DICTDBL 
to recover the data base. 












CONTROL(Y) NOT ENABLED Attempt to enable control Y failed. 






HIGH MASTER SET OCCUPANCY 





The occupancy of a master set is 
higher than 80%. Consider increasing 
the data set capacity to reduce the 

occurrence of synonym chains (unless 
the capacity is only one entry). 








SERIAL COUNT ERROR 





Physical serial read count of a 
master set does not equal the IMAGE 
table count. The data base should be 
unloaded serially with DICTDBU and 
then reloaded with DICTDBL to recover 
the data base. 
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DICTDBC MESSAGES 


Errors 


MESSAGE EXPLANATION AND/OR ACTION 


BAD PASSWORD The dictionary data base cannot be opened 
because the password entered is 
incorrect. 








CANNOT OPEN DATA BASE DICT.PUB The dictionary data base cannot be 
IMAGE error message opened. The error message returned by 
IMAGE is shown. 










DBSCHEMA PROCESSOR CANNOT BE Utility has been unable to activate the 
ACTIVATED DBSCHEMA program. Contact your system 
manager. 












DBSCHEMA PROCESSOR CANNOT BE Utility has been unable to invoke the 
INVOKED DBSCHEMA program in the PUB group of the 
SYS account. Contact your system manager. 







DICTIONARY ACCESS, PROBABLY AN The dictionary schema is incompatible 
INCOMPATIBLE DICTIONARY DATA with current release of the utility. 
BASE 









DICTIONARY DATA BASE OPERATION A data base error occurred. An IMAGE 
"DBEXPLAIN message block" is issued to 
explain the error condition. 







EXCEEDED 255 ITEMS IN BASE Utility has found more than 255 data 
items for the base in the dictionary and 
that is the limit for an IMAGE data base. 
The schema is generated without the 

excess data items. 









EXCEEDED 63 CLASSES IN BASE Utility has found more than 63 security 
classes for the base in the dictionary 
and that exceeds the limit for an IMAGE 
data base. The schema is generated 

without the excess security classes. 
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DICIDBC MESSAGES (continued) 


Errors (continued) 


MESSAGE EXPLANATION AND/OR ACTION 


EXCEEDED 99 SETS IN BASE 


FILE NAME TOO LONG 


INVALID LIST FILE 


INVALID STORAGE LENGTH FOR 
ITEM: item-name 


LINE LONGER THAN 70 CHARACTERS 
PASSWORD DOES NOT ALLOW ACCESS 
TO 'CLASS-PASSWORD' 


PASSWORD LONGER THAN 8 
CHARACTERS 


PROCESS TERMINATED ON FATAL . 
ERROR CONDITION 


SCHEMA FILE WRITE 


Utility has found more than 99 data sets 
for the base in the dictionary and that 
is the limit for an IMAGE data base. The 
schema is generated without the excess 
data sets. 


Response to SCHEMA FILE or LIST FILE is 
greater than 26 characters. 


Response to the LIST FILE prompt is not a 
valid file name. 


Utility has detected a dictionary item 
whose storage length is invalid for the 
given type. Correct the storage length in 
the dictionary using the DICTDBM utility. 


The response to CONTROL LINE is longer 
than 70 characters. 


Password does not grant sufficient 
capability to create a data base. 


Response to DICTIONARY PASSWORD 
prompt is greater than 8 characters. 


A fatal error occurred during the utility 
process and the program has been 
terminated. 


Error detected in writing schema file. A 
"file error tombstone" is issued to 
explain the error condition. 
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DICTDBC MESSAGES (continued) 


Errors (continued) 





MESSAGE EXPLANATION AND/OR ACTION 


STORAGE LENGTH TOO SMALL FOR Utility has detected a dictionary 
ITEM: item-name item whose storage length definition 
is too small to contain values. 
Correct the item type, size, or 
storage length in the dictionary 
using the DICTDBM utility. 


TEMPORARY FILE ACCESS Error occurred using the temporary 
file in preparing the schema file. 
A "file error tombstone” is issued 
to explain the error condition. 


TEMPORARY FILE OPEN A temporary file used in preparing 
the schema file cannot be opened. 
A “file error tombstone" is issued 
to explain the error condition. 


LIST FILE OPEN Device LP is not available. File equate 
DICTLIST, which defaults to LP. 
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Utility Error Messages 


DICTDBC MESSAGES (continued) 


Warnings 


MESSAGE EXPLANATION AND/OR ACTION 


BASE NAME TRUNCATED TO 6 
CHARACTERS 


CONTROL(Y) NOT ENABLED 


The name of a base can be up to 20 
characters in the dictionary, but 
only the first 6 are used for 
generating the physical data base 
file name. 


Attempt to enable control Y failed. 
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Utility Error Messages 


DICTDBC MESSAGES (continued) 


Condition Prompts 


MESSAGE EXPLANATION AND/OR ACTION © 


[TEMPORARY] FILE ALREADY EXISTS, The file name entered in response to the 

‘PURGE OLD(N/Y)?> SCHEMA FILE prompt already exists as a 
temporary or a permanent file. Respond 
"y" to purge the existing file and keep 
the new file. 
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DICTDBD MESSAGES 


Errors 


MESSAGE EXPLANATION AND/OR ACTION 


BASE ALREADY DEFINED IN The data base name is already in the 

DATA DICTIONARY dictionary. The user is prompted as to 
whether the data base should be given a 
different name when loaded into the 
dictionary. 


BASE NAME TOO LONG Data base name, including qualifiers, 
exceeds 24 characters. 


DATA BASE OPERATION A data base error occurred when reading 
information. An IMAGE "DBEXPLAIN message 
block" is issued to explain the error 
condition. 


DATA DICTIONARY OPERATION A data dictionary error occurred. An 
IMAGE "DBEXPLAIN message block" is issued 
to explain the error condition. 


INVALID MODE Response to MODE prompt is a number other 
than 1 through 8. 


ITEM SEARCH IN DBINFO LIST A system error occurred in processing 
"DBINFO" information from the data base. 
If the cause is not apparent, contact 
your system manager. 


PASSWORD LONGER THAN 8 Response to DICTIONARY PASSWORD or BASE 
CHARACTERS PASSWORD prompt is greater than 8 
characters. 





Utility Error Messages 


DICTDBD MESSAGES (continued) 


Warnings 


MESSAGE EXPLANATION AND/OR ACTION 


| CONTROL (Y) NOT ENABLED “Arming" control Y failed. 


DATA SET HAS NOT BEEN LOADED Response to the NEW PRIMARY FILE NAME 
INTO DICTIONARY prompt is RETURN, or response to USE 
EXISTING DEFINITION (N/Y)? prompt is "N" 


or RETURN. 


ELEMENT HAS NOT BEEN LOADED INTO Response to the NEW PRIMARY ELEMENT NAME 
DICTIONARY prompt is RETURN. 
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DICTDBD MESSAGES (continued) 


Condition Prompts 


MESSAGE EXPLANATION AND/OR ACTION 


ENTIRE DEFINITION OF DATA BASE Definition of data base will not fit in 






WILL NOT FIT IN DICTIONARY, dictionary. Respond "N" to terminate 
PROCEED (N/Y)? utility; respond "Y" to continue until 
one of the data sets is full, then 






terminate. 
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DICTDBL MESSAGES 


Errors 
MESSAGE EXPLANATION AND/OR ACTION 
BAD DATA BASE NAME: base-name The utility has encountered an invalid 
: base name format in the store file. 
Probably the store file has bad data in 
pS oe 
BASE LONGER THAN 6 CHARACTERS Base name exceeds 6 characters. 


BASE NAME TOO LONG Data base name, including qualifiers, 
exceeds 24 characters. 


DATA BASE OPERATION A data base error occurred during the 
load. A "DBEXPLAIN message block" is 
issued to explain the error condition. 


DEFERRED MODE REJECTED, The request for fast I/O has been 

CODE=n rejected with an error code of "n". 
Refer to the DBCONTROL intrinsic in the 
IMAGE Reference Manual for an 
explanation. 


FILE EQUATION NOT ALLOWED A back-referenced file name (*filename) 
entered as a response to the STORE FILE 
prompt is not allowed. 


FILE NAME TOO LONG Response to the LIST FILE prompt is 
greater than 26 characters. 


INCOMPATIBLE STORE FILE The store file is incompatible with 
current release of the utility. 


INCORRECT STORE TAPE MOUNTED The tape mounted is not the correct 
tape. Mount the correct tape. 


INCORRECT TAPE NUMBER: n The given tape number "n" is out of 
sequence. Mount the correct tape. 


INVALID MODE Response to MODE prompt is a number 
than 1 through 8. 
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DICTDBL MESSAGES (continued) 


Errors (continued) 


| MESSAGE EXPLANATION AND/OR ACTION 


INVALID RUN MODE Response to the RUN MODE prompt is 
. invalid. Enter one of the modes indicated 
in the prompt. 


- ITEM CONVERSION A conversion error occurred on an item 
with properties that have changed in the 
new data base schema. The item data field 
is set to a null value of all binary 
zeros. 


ITEM NAME TOO LONG Data item name entered in response to the 
NEW ITEM NAME prompt is longer than 16 
characters. 


PASSWORD LONGER THAN 8 Response to the BASE PASSWORD prompt is 
CHARACTERS greater than 8 characters. 


PRINT FILE CANNOT BE OPENED The print file for the listing cannot be 
opened. Enter a correct file name to the 
LIST FILE prompt. 


SET NAME TOO LONG Data set name entered in response to the 
NEW SET NAME prompt is longer than 16 
characters. 


STORE FILE OPEN The store file cannot be opened. A "file 
error tombstone" is issued to explain the 
error condition. 
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DICTDBL MESSAGES (continued) 


Warnings 


MESSAGE EXPLANATION AND/OR ACTION 


CONTROL(Y) NOT ENABLED ~ "Arming" control Y failed. 





Utility Error Messages 


DICTDBL MESSAGES (continued) 


Condition Prompts 


MESSAGE EXPLANATION AND/OR ACTION 


CONTINUE SET LOAD(Y/N)?> After an error or a control Y interrupt, 
this prompt allows the user to continue 
the operation or to terminate the utility 
program. 


CONTROL(Y) BREAK, User has entered control Y during a data 
CONTINUE (Y/N)?> set load. A response of "N" will 
terminate the utility program. 


DISPLAY INPUT RECORD(Y/N)?> After an IMAGE error in trying to store a 
new record in the data base, this prompt 
allows the user to dump the record to the 
list file in ASCII and octal format. 


LIST FILE ALREADY EXISTS, The list file is being written to disc 

PURGE OLD(N/Y)?> and a file of the same name already 
exists. Respond "Y" to purge the existing 
file and keep the new file. 


TAPE FILE REQUESTED (Y/N) This prompt is issued if RETURN is 
entered in response to the STORE FILE 
prompt. If an "N" response is given, the 
utility program terminates. 





Utility Error Messages 


DICTDBU MESSAGES 


Errors 
MESSAGE EXPLANATION AND/OR ACTION 
BASE LONGER THAN 6 CHARACTERS - Base name exceeds 6 characters. 


DATA BASE OPERATION A data base error occurred. A "DBEXPLAIN 
message block" is issued to explain the 
error condition. 


DBINFO OPERATION The utility encountered an error when 
using a "DBINFO" call to IMAGE. A 
"DBEXPLAIN message block" is issued to 
explain the error condition. 


DBINFO - SERIAL UNLOAD INVOKED The utility encountered an error in the 
DBINFO information from IMAGE for the 
data base structure. A "DBEXPLAIN message 
block" is issued to explain the error 
condition. The utility has rejected the 
request for the chained unload of the 
current data set and is performing a 
serial unload. 


FILE EQUATION NOT ALLOWED A back-referenced file name (*filename) 
entered as a response to the STORE FILE 
prompt is not allowed. 


FILE NAME TOO LONG Response to the LIST FILE prompt is 
greater than 26 characters. 


INCORRECT SYNTAX IN USE OF An incorrect qualified name entered in 
PERIOD(S) response to the BASE prompt. 


INVALID MODE Response to MODE prompt is a number other 
than 1 through 8. 


ITEM NOT FOUND Named item is not found in the definition 
of the set when EDIT MODE used. 


LIST FILE The utility encountered an error when 
accessing the list file. A "file error 
tombstone" is issued to explain the error 
condition. 





Utility Error Messages 


DICTIDBU MESSAGES (continued ) 


Errors (continued) 


MESSAGE EXPLANATION AND/OR ACTION 


PASSWORD LONGER THAN 8 Response to BASE PASSWORD prompt is 
CHARACTERS greater than 8 characters. 














PRINT FILE CANNOT BE OPENED The print file for the listing cannot be 
opened. Enter a correct file name to the 
LIST FILE prompt. 


SEARCH ITEM NOT FOUND Named item is not a search item within 
the detail set when EDIT MODE used. 





STORE FILE CANNOT BE CLOSED The utility was unable to close the store 
file in either the permanent or temporary 
file domain. Contact your system manager. 


STORE FILE EXISTS AND CANNOT Accessing the named store file is a 
BE ACCESSED security violation. 












STORE FILE OPEN The store file cannot be opened. A "file 
error tombstone" is issued to explain the 
error condition. 


STORE FILE WRITE The utility encountered an error when 

. writing the store file. A "file error 
tombstone" is issued to explain the error 
condition. 


DICTDBU MESSAGES (continued) 


Warnings 





} CONTROL(Y) NOT ENABLED 


INSUFFICIENT GROUP DISC SPACE - 
STORE FILE IS SESSION TEMPORARY 


MESSAGE EXPLANATION AND/OR ACTION 


Utility Error Messages 





"Arming" control Y failed. 





The utility was unable to close the store 
file in the permanent file domain because 
of insufficient disc space allocation in 
the file group. The store file is session 
temporary and will be lost when the user 
logs off. If you would like to keep the 
store file as a permanent file, you 
should contact your system manager for a 
higher disc space allocation. Save the 
temporary file to the permanenet domain 
by using the MPE SAVE command. 
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DICTDBU MESSAGES (continued) 


Condition Prompts 


MESSAGE EXPLANATION AND/OR ACTION 


CONTINUE SET UNLOAD(Y/N)?> After an error or a control Y interrupt, 
this prompt allows the user to continue 
the operation or to terminate the utility 
program. 








CONTROL(Y) BREAK, User has entered control Y during a data 
CONTINUE (Y/N) ?> set unload. A response of "N" will 
terminate the utility program. 








LIST FILE ALREADY EXISTS, The list file is being written to disc 
PURGE OLD(N/Y)?> and a file of the same name already 

. exists. Respond "Y" to purge the existing 
file and keep the new file. 








STORE FILE ALREADY EXISTS, The store file is being written to disc 

PURGE OLD(N/Y)?> and a file of the same name already 
exists. Respond "Y" to purge the existing 

file and keep the new file. 







This prompt is issued if RETURN is 
entered in response to the STORE FILE 

prompt. If an "N" response is given, the 
utility program terminates. 


TAPE FILE REQUESTED(Y/N) 
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DICTIONARY /3000 
INITIALIZATION PROCEDURE 





Once Dictionary/3000 software has been installed on your system, you must 
execute the program DICTINIT to create and initialize a data dictionary. This 
program allows you to customize the dictionary for your application and to 
define the security for the dictionary. It also allows you to re-initialize 
an existing dictionary when you want to change the passwords for access or to 
change the capacities of the data sets in the dictionary. 


The dictionary is created in the MPE group and account from which the 
DICTINIT program is run. The dictionary maintenance program (DICTDBM) and 
the dictionary utility programs all assume the dictionary exists in the PUB 
group of the log-on account. If you create a dictionary in a different group 
and/or account, you will first have to identify these before running DICTDBM 
or the utilities. You do this by issuing a file equation as follows: 


FILE pipe thee neegrvercermee cnn 


When running DICTINIT, you can define five levels of access to the 
dictionary. You do this by assigning a password to each level. The access 
levels are hierarchical - that is, each level is given the capability for its 
level and all levels below. The topmost level of MANAGER has complete and 
total access to the dictionary. The mid-level of INFORM has access for 
INFORM as well as for DOCUMENTATION and REPORT, and so forth. 


Entries that pertain to security, such as security class numbers and 
passwords, can only be created and modified by someone using the password 
assigned to MANAGER. A description of each possible level and the access 
capability given to each follows: 
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LEVEL ACCESS CAPABILITY WHO SHOULD USE 
MANAGER Total access. The person responsible for the 
. data dictionary. 

PROGRAMMER Can modify entries except Anyone who needs to create and 
security entries; . maintain files and elements in 
can read security entries. the dictionary in the course of 

applications development. 

INFORM Can modify HP Inform/3000 Anyone responsible for the 
group entries and all maintenance of the HP 
entries below; Inform/3000 program. 
cannot read/modify security 
entries. 

DOCUMENTATION | Can modify documentation Anyone responsible for 
entries and all entries maintaining documentation 
below; entries in the dictionary 
cannot read/modify security (PROCEDURES, LOCATIONS, or 
entries. CATEGORIES). 

REPORT Can modify NO entries; Anyone who needs to write 


can read all entries except 
security entries. 


reports about the contents of 
the dictionary. 


Once passwords for the various levels are assigned, there is no way for you 
to see them within Dictionary/3000. If you are the data base creator, you 
can run DBUTIL and see the passwords. (Refer to the IMAGE/3000 Reference 
Manual for a description of the DBUTIL utility.) If not, you can run the 
DICINIT program again and use the RE-INITIALIZATION option to assign new 
passwords. 


If you do not specify a password for a particular level, that security level 
is deleted - there is no access at that level. The MANAGER level cannot be 
deleted; you must specify a password for the MANAGER level. 


There are two phases to the DICTINIT program. During the first phase 
(initialization), information provided by the Dictionary/3000 software is 
used to create a temporary dictionary which is automatically purged at the 
end of phase two. To create this temporary dictionary, a special stream job 
is automatically invoked by DICTINIT. If you use passwords at either the 
user, account, or group level when you log on, the stream job prompts you to 
enter them before it begins. 


Initialization Procedure 


You should monitor the status of the stream job to be sure no errors are 
encountered. If the job was able to complete, a message informing you to run 
DICTINIT.PUB.SYS,UPDATE for phase two is displayed. If the job aborts, the 
line printer listing will tell you why. After correcting the problem, you can 
begin again. 


Phase two (customization) allows you to customize your dictionary or use the 
defaults, and to assign passwords for the levels of access. At the end of 
phase two another stream job is invoked. This job builds your permanent data 
dictionary. If the job in phase two completes successfully, you are informed 
that DICTINIT IS COMPLETE. If you do not receive this message, but the job 
has finished, check the line printer listing for the errors. After 
correcting them, rerun DICTINIT.PUB.SYS,UPDATE 


You can terminate DICTINIT by entering a CNTL-Y at any time. If you enter a 
CNTL-Y while running phase two, any changes that have been verified are 
accepted and become the defaults when phase two is run again. 


A complete list of all error messages, including what to do to recover, is 
given following the examples. 
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EXAMPLE 1 


To initialize a new data dictionary using the default capacities provided by 
HP, simply follow the process below - substituting your responses for the 
ones shown where appropriate. The first step is to log on to the group and 
account in which you want the dictionary to appear. Then follow the 
following example: 


>-RUN DICTINIT.PUB.SYS How to start initialization process. 
<The Dictionary/3000 initialization program banner goes here.> 


Initialization/Re-initialization (I/R) >i Select "I" to build a new 


dictionary. 
USER PASSWORD > If logon passwords were used, enter 
. them in response to these prompts. 
ACCOUNT PASSWORD >LOCKIT They are used by the batch job that 


installs a temporary dictionary. 
GROUP PASSWORD > 


#333 Number of the STREAMed job which 
performs step one (initialization). 
END OF PROGRAM End of step one. 


FROM/<your account>/PLEASE RUN DICTINIT.PUB.SYS,UPDATE 
This message informs you that the 
job is complete, and you are to 
perform step two (customization). 

:RUN DICTINIT.PUB. SYS ,UPDATE . Performing step two. 

<The Dictionary/3000 initialization program banner goes here. > 


Initialization/Re-initialization (I/R) >i Again - new dictionary. 


Dictionary capacities: Default or Provided (D/P) ->d Use the default 


capacities. 
DATA-ELEMENT will have capacity 100] Listing of the capacities 
DATA-FILE will have capacity 503 for your examination. 


DATA-PROCEDURE will have capacity 203 
DATA-CATEGORY will have capacity 203 


DATA-GROUP will have capacity 503 
DATA-CLASS will have capacity 203 
DATA- LOCATION will have capacity 203 
LINK-FILE will have capacity 401 


LINK-ELEMENT will have capacity 401 
LINK-DESCRIPTION will have capacity 2003 


DATA-REPORTLOC will have capacity 503 
ELEMENT-ELEMENT will have capacity 500 
FILE-FILE will have capacity 250 
PROCEDURE-PROCED will have capacity 100 
CATEGORY-CATEGOR will have capacity 100 
GROUP - GROUP will have capacity 250 
FILE-ELEMENT will have capacity 2000 
FILE-PATH will have capacity 400 
FILE-SORT will have capacity 400 
PROCEDURE-ELEMEN will have capacity 500 
CATEGORY-ELEMENT will have capacity 500 


Press RETURN to continue > 


GROUP - ELEMENT 
CLASS- ELEMENT 


will have capacity 1000 
will have capacity 3000 
CLASS-FILE will have capacity 500 
FILE-LOCATION will have capacity 500 
PROCEDURE-LOCATI will have capacity 200 
DESCRIPTION-TEXT will have capacity 5000 
REPORT-LIST ~ will have capacity 500 


Are the capacities correct? (Y/N) >y 


Password for MANAGER access >DICTMGR 
Password for PROGRAMMER access >DICPRG 
Password for INFORM access >DICINF 
Password for DOCUMENTATION access > 
Password for REPORT access >DICRPT 
MANAGER 


PROGRAMMER 
INFORM 


Password for 
Password for 
Password for 
There will be no DOCUMENTATION 
Password for REPORT 


Are the passwords correct? (Y/N) >y 


access will be DICTMGR 
access will be DICPRG 
access will be DICINF 


access allowed 


Initialization Procedure 


Press RETURN to see the rest 
of the display; it fills more 
than one screen in this case. 


This prompt gives you a chance 
to answer "N" and change them; 
here we say yes. 


These prompts allow you to 
specify the security levels 
and their passwords; you can 
respond with a password or 
simply press RETURN for no 
access at that level. 


Program lists the 
passwords assigned. 


RETURN was pressed, 
nullifying that level. 


access will be DICRPT 


You can change the passwords 
by responding "N". 


Initialization Procedure. 


USER PASSWORD > Again - any log-on passwords 
. are needed to start the final 
ACCOUNT PASSWORD >LOCKIT initialization job which actually 


creates the new dictionary. 
GROUP PASSWORD > 


#J34 Number of the final job. 
END OF PROGRAM End of customization step. 


FROM/<your account>/DICTINIT IS COMPLETE ‘The program is complete; your 
dictionary is initialized. 


Initialization Procedure 


EXAMPLE 2 


This example demonstrates how to enter your own capacities and change them 
after they are displayed. As before, log on to the group and account in 
which you want the dictionary before starting. 

>RUN DICTINIT.PUB.SYS How to execute the program. 


<The Dictionary/3000 initialization program banner goes here> 


Initialization/Re-initialization (I/R) >i Select "I" to build a new 


dictionary. 
USER PASSWORD > 
ACCOUNT PASSWORD >LOCKIT If a user, account, or group 
password is required, enter 
GROUP PASSWORD > it in response to these prompts. 


#J35 

END OF PROGRAM 

FROM/<your account>/PLEASE RUN DICTINIT.PUB.SYS,UPDATE Informs you to run 
step two. 

“RUN DICTINIT .PUB.SYS,UPDATE 


<The Dictionary/3000 initialization program banner goes here.> 


Initialization/Re-initialization (I/R) >i Select "I" to build a new 
dictionary. 


Dictionary capacities: Default or Provided (D/P) >p Select "P" to enter 
new capacities; old 
ones are displayed. 


DATA-ELEMENT has capacity 100] 
New capacity for DATA-ELEMENT > 1002 
DATA-FILE has capacity 503 
New capacity for DATA-FILE >» 504 


DATA-PROCEDURE has capacity 203 
New capacity for DATA-PROCEDURE > 204 


DATA-CATEGORY has capacity 203 


New capacity for DATA-CATEGORY >» 204 
DATA-GROUP has capacity 503 
New capacity for DATA-GROUP >» 504 
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DATA-CLASS 
New capacity for 


DATA- LOCATION 
New capacity for 


LINK-FILE 
New capacity for 


LINK-ELEMENT 
New capacity for 


LINK-DESCRIPTION 
New capacity for 


DATA-REPORTLOC 
New capacity for 


ELEMENT -ELEMENT 
New capacity for 


FILE-FILE 
New capacity for 


PROCEDURE -PROCED 
New capacity for 


CATEGORY -CATEGOR 
New capacity for 


GROUP -GROUP 
New capacity for 


FILE-ELEMENT 
New capacity for 


FILE-PATH 
New capacity for 


FILE-SORT 
New capacity for 


PROCEDURE -ELEMEN 
New capacity for 


CATEGORY -ELEMENT 
New capacity for 


GROUP -ELEMENT 
New capacity for 


has capacity 203 
DATA-CLASS 


has capacity 203 
DATA-LOCATION 


has capacity 40] 
LINK-FILE 


has capacity 401 
LINK-ELEMENT 


has capacity 2003 


LINK-DESCRIPTION 


has capacity 503 
DATA-REPORTLOC 


has capacity 500 
ELEMENT -ELEMENT 


has capacity 250 
FILE-FILE 


has capacity 100 
PROCEDURE -PROCED 


has capacity 100 
CATEGORY -CATEGOR 


has capacity 250 
GROUP - GROUP 


has capacity 2000 
FILE-ELEMENT 


has capacity 400 
FILE-PATH 


has capacity 400 
FILE-SORT 


has capacity 500 
PROCEDURE -ELEMEN 


has capacity 500 
CATEGORY -ELEMENT 


has capacity 1000 
GROUP -ELEMENT 


> 


204 
Seeile RETURN keeps the old 
capacity. 

402 

402 

2004 

504 

501 

25] 

101 


101 


251 


40] 
40] 
501 
501 


100] 


CLASS-ELEMENT 
New capacity for 


CLASS-FILE 
New capacity for 


FILE-LOCATION 
New capacity for 


PROCEDURE -LOCATI 
New capacity for 


DESCRIPTION-TEXT 
New capacity for 


REPORT-LIST 
New capacity for 


DATA-ELEMENT 
DATA-FILE 
DATA-PROCEDURE 
DATA-CATEGORY 
DATA-GROUP 
DATA-CLASS 
DATA-LOCATION . 
LINK-FILE 
LINK-ELEMENT 
LINK-DESCRIPTION 
DATA-REPORTLOC 
ELEMENT-ELEMENT 
PLLE=PILe 
PROCEDURE - PROCED 
CATEGORY -CATEGOR 
GROUP - GROUP 
FILE-ELEMENT 
FILE-PATH 
FILE-SORT 
PROCEDURE -ELEMEN 
CATEGORY -ELEMENT 


has capacity 3000 
CLASS-ELEMENT 


has capacity 500 
CLASS-FILE 


has capacity 500 
FILE-LOCATION 


has capacity 200 
PROCEDURE -LOCATI 


has capacity 5000 
DESCRIPTION-TEXT 


has capacity 500 
REPORT-LIST 


will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 
will 


have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 
have 


Press RETURN to continue > 


GROUP - ELEMENT 
CLASS-ELEMENT 
CLASS-FILE 
FILE-LOCATION 
PROCEDURE -LOCATI 
DESCRIPTION-TEXT 
REPORT-LIST _ 


will 
will 
will 
will 
will 
will 
will 


have 
have 
have 
have 
have 
have 
have 


capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 
capacity 


capacity 
capacity 
capacity 
capacity 
capacity 
capacity. 
capacity 
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> 3001 


> 500] 


> 501 


1002 
504 
204 
204 
504 
204 
203 
402 
402 
2004 
504 
501 
251 
10] 
101 
251 
2000 
40] 
40] 
50] 
501 


Listing of capacities. 


100] 
3001 
501 
50] 
201 
5001 
501 
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Are the capacities correct? (Y/N) >n Enter "N" to change values. 

Data-set name (DONE/ALL/name) >report-list Change capacity of data 
set REPORT-LIST. 

REPORT-LIST has capacity 501 

New capacity for REPORT-LIST > 200 > 


Data-set name (DONE/ALL/name) >description-text 


DESCRIPTION-TEXT has capacity 5001 
New capacity for DESCRIPTION-TEXT > 5000 


Data-set name (DONE/ALL/name) >done Enter DONE to stop 
changing capacities. 


DATA-ELEMENT will have capacity 1002 Listing of capacities. 


Press RETURN to continue > 


DESCRIPTION-TEXT will have capacity 5000 
REPORT-LIST will have capacity 200 


Are the capacities correct? (Y/N) >y 


Password for MANAGER access >DICTMGR 


Password for PROGRAMMER access > Entering RETURN indicates that 
there will be no access to the 
Password for INFORM access > dictionary at these levels. 


Password for DOCUMENTATION access > 


Password for REPORT access > 


Password for MANAGER access will be DICTMGR Listing of passwords 
There will be no PROGRAMMER access allowed assigned. 

There will be no INFORM access allowed 

There will be no DOCUMENTATION access allowed 


There will be no REPORT access allowed 
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Are the passwords correct? (Y/N) >y 


USER PASSWORD > 
ACCOUNT PASSWORD >LOCKIT 


GROUP PASSWORD > 
#J36 


END OF PROGRAM 


FROM/<your account>/DICTINIT IS COMPLETE Program is complete; your 
dictionary is initialized. 
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EXAMPLE 3 


This example shows a dictionary re-initialization. That is, there is already 
a data-dictionary in your group, and you want to resize it and/or change the 
passwords to access it. 


RUN DICTINIT.PUB.SYS How to execute the program. 

<The Dictionary/3000 initialization program banner goes here> 

Initialization/Re-initialization (I/R) >r Select "R" to re-initialize 

an existing dictionary. 

USER PASSWORD > 
If logon passwords were used, enter 

ACCOUNT PASSWORD > them in response to these prompts. 

GROUP PASSWORD > 

Dictionary store file on Tape or Disk(T/D) >d 
The present contents of the dictionary 
will be stored by DICTINIT, to be 
recovered into the new dictionary when 
it is created. This store file may be 
quite large, and you may not have the 
disk space to hold it. In this case, 
you may store it to tape. Otherwise, 
request DICTINIT to use a disk file, 
as in this example. 

#J46— 

END OF PROGRAM 

FROM/<your account>/PLEASE RUN DICTINIT.PUB.SYS,UPDATE End of step one. 

>-RUN DICTINIT.PUB.SYS,UPDATE Execute step two. 

<The Dictionary/3000 initialization program banner goes here> 

Initialization/Re-initialization (I/R) >r Select R to re-initialize. 


Dictionary capacities: Default or Provided (D/P) >d Use defaults. 


DATA-ELEMENT will have capacity 100] Listing of capacities. 
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CATEGORY-ELEMENT will have capacity 500 
Press RETURN to continue > 


GROUP - ELEMENT will have capacity 1000 


REPORT -LIST will have capacity 500 

Are the capacities correct? (Y/N) >y 

Password for MANAGER access >DICTMGR Enter passwords for the various 
security levels. 

Password for PROGRAMMER access > 

Password for INFORM access >DICINF 

Password for DOCUMENTATION access > 


Password for REPORT access >DICRPT 


Password for MANAGER access will be DICTMGR Listing of 
There will be no PROGRAMMER access allowed passwords. 
Password for INFORM access will be DICINF 

There will be no DOCUMENTATION access allowed 

Password for REPORT access will be DICRPT 


Are the passwords correct? (Y/N) >y 


USER PASSWORD > If log-on passwords were used, 
enter them in response to these 
ACCOUNT PASSWORD > prompts. 


GROUP PASSWORD > 


Dictionary store file on Tape or Disk(T/D) >d Indicates a disk file; 
must be answered as in 
#J50 step one. 


END OF PROGRAM 
FROM/<your account>/DICTINIT IS COMPLETE The program is complete; 


your dictionary is now 
re-initialized. 
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DICTINIT ERROR MESSAGES 


The error messages are divided into three groups. The first group 
corresponds to step 1 (initialization). The second group corresponds to step 
2 (customization). The third group corresponds to the final initialization 
job stream at the end of step 2, which builds your permanent dictionary. 


_ Group 1 - Initialization Startup Errors 

The error messages you might receive during the initialization startup phase 

(while running DICTINIT.PUB.SYS) are as follows: 

YOU DO NOT HAVE BATCH ACCESS CAPABILITY 
In order to run the job streams that initialize the dictionary, the user, 
group, and account must all have BA capability. Consult your system or 
account manager. 

PLEASE PURGE file AND RERUN DICTINIT 
file is one of the files MDIC, DICT, MDSCH. These files are used in the 
initialization process, and so cannot appear in your log-on group. You 
should either rename them or purge them. 

DICTIONARY DATA-BASE DICT MUST EXIST TO RE-INITIALIZE 
When re-initializing, the data base file named DICT must exist in your 
logon group and account. Check to make sure you are in the correct group 
and account, then retry. 

ERROR OCCURRED WRITING STREAM FILE 
This message is preceded by an MPE file system error message. Refer to 
the MPE 3000 Error Messages and Recovery Reference Manual. The error 
prevented opening, writing, or closing the stream file which will perform 
the batch processing. Consult your system manager. 

JOB COULD NOT START - INVALID PASSWORD 
One of the passwords required for logon (account, user, or group) was 


either missing or incorrect. Check your passwords and respond again to 
the password prompts. Note that leading blanks are not allowed. 
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COMMAND ERROR = nnnn 
ERROR OCCURRED STREAMING JOB 


nnnn is the number of a CIERR or CIWARN message. Consult the MPE 3000 
Error Messages and Recovery Reference Manual for the full text. The error 
occurred while executing a STREAM command to start the phase 1 job which 
creates the temporary dictionary. Consult your system manager. 


FROM /your account/file system error message 

FROM /your account/ ERROR OCCURRED OPENING FILE MDSCH 
FROM /your account/ ERROR OCCURRED WRITING FILE MDSCH 
FROM /your account/ ERROR OCCURRED CLOSING FILE MDSCH 


You will receive the first line, which is an MPE file system error message 
detailing the error, and one of the next three lines, which will tell you 
what DICTINIT was trying to do at that time. MDSCH is a schema file 
describing the temporary dictionary. Consult the MPE 3000 Error Messages 
and Recovery Reference Manual to resolve the MPE error, then rerun 
DICTINIT. These messages come from the job that was invoked for you. 


Group 2 -— Customization Errors 

The error messages you might receive during the customization phase (while 

running DICTINIT.PUB.SYS,UPDATE) are as follows: 

YOU DO NOT HAVE BATCH ACCESS CAPABILITY 
In order to run the job streams that initialize the dictionary, your group 
must have BA capability. Consult your system or account manager. 

*DB ERROR: IMAGE data base error message 
This error occurs while manipulating the temporary dictionary. Consult 
your system manager if you receive one of these messages. The data base 
error message corresponds to an IMAGE error message from the DBERROR 
facility. Consult the IMAGE/3000 Reference Manual. 

ERROR OCCURRED OPENING MDIC 
This is preceded by a *DB ERROR: message. This error may occur if phase 


two is run before the stream job from phase one completes. Wait to 
receive the message to run the UPDATE portion of DICTINIT. 
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ERROR IN INITIALIZING CAPACITIES FROM MDIC 
This is preceded by a *DB ERROR: message. This occur occurs while reading 
default capacities in MDIC. 

ERROR IN UPDATING CAPACITIES TO MDIC 
This is preceded by a *DB ERROR: message. . The error occurs after you 
respond that the capacities are correct, and the information is being 
transferred. . 

ERROR OCCURRED CLOSING MDIC 
Consult your system manager. 

CAPACITY MUST BE A NUMBER 

CAPACITY MUST BE LESS THAN 2,147,483,647 

RESPONSE MUST BE 10 CHARACTERS OR LESS 

CAPACITY MAY NOT BE ZERO 
All these messages come from invalid responses to the NEW CAPACITY prompt. 
(Note that the capacity should probably be MUCH less than 2,147,483,647. ) 

THE DATA SET NAME DOES NOT EXIST 
This comes from an invalid (or misspelled) data set name in response to 
the DATA-SET NAME(DONE/ALL/name) prompt. 

YOU MUST ENTER A PASSWORD FOR MANAGER ACCESS 
All the other security levels may be deleted by pressing RETURN in 


response to the PASSWORD prompt - EXCEPT manager, which must have a 
password. 


PASSWORD MUST BE 8 CHARACTERS OR LESS 
PASSWORD MAY NOT CONTAIN A SEMICOLON (;) 


These messages are the result of invalid responses to a PASSWORD prompt. 
Reenter the PASSWORD. 
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UNEXPECTED ERROR: MANAGER PASSWORD IS NULL, 
PLEASE REENTER THE PASSWORDS 


Reenter all the passwords. 


ERROR OCCURRED UPDATING MDIC WITH NEW SECURITY 


This is preceded by a *DB ERROR: message. Please consult your system 
manager before proceeding. 


DISK STORE FILE MDSCH NOT FOUND 


You responded D for the re-initialization prompt for tape or disk. In 
that case, the file MDSCH must be present, and must contain the contents 
of the old data-dictionary. Either respond T if on tape, or locate MDSCH. 


JOB COULD NOT START - INVALID PASSWORD 


One of the passwords required for logon (user, account, or group) was 
missing or incorrect. Check your passwords and respond again to the 
password prompts. Note that leading blanks are not allowed. 


FILE ERROR: MPE file system error message 
ERROR OCCURRED WRITING STREAM FILE 


This message is preceded by an MPE file system error message. See the MPE 
3000 Error Messages and Recovery Reference Manual. The error prevented 
opening, writing, or closing the stream file which will perform the batch 
processing. Consult your system manager. 


COMMAND ERROR = nnnn 
ERROR OCCURRED STREAMING JOB 


mnnn is the number of a CIERR or CIWARN message. Consult the MPE 3000 
Error Messages and Recovery Reference Manual for the full text. The error 
occurred while executing the STREAM command to start the phase 1 job, 
which creates the temporary dictionary. Consult your system manager. 
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Group 3 - Final Initialization Errors 


The error messages 
the end of phase 2 


FROM/your 
FROM/your 
FROM/your 
FROM/your 
FROM/your 


account / 
account / 
account / 
account / 
account / 


you might receive during the final initialization job at 
are as follows: 


*DB ERROR: IMAGE data base error message 
ERROR OCCURRED OPENING MDIC 

ERROR OCCURRED READING CLASS nn 

ERROR OCCURRED REINITIALIZING CLASS nn 
ERROR OCCURRED CLOSING MDIC 


You will receive the first line, followed by one of the next four lines. 


nn is the number of a security class entry in MDIC. 
system manager before proceeding. 


was invoked for you. 


FROM/your 
FROM/your 
FROM/your 
FROM/your 
FROM/your 
FROM/your 
FROM/your 


account / 
account / 
account / 
account / 
account / 
account / 
account / 


Please consult your 
These messages come from the job that 


*DB ERROR: IMAGE data base error message 


ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 


OCCURRED 
OCCURRED 
OCCURRED 
OCCURRED 
OCCURRED 
OCCURRED 


The first message will appear, 
number of a security class). 
proceeding. These messages come from the job that was invoked for you. 


OPENING DICT 
INITIALIZING DIC-CONTROL 
INITIALIZING DATA-GROUP 
DELETING A CLASS 
INITIALIZING CLASS nn 
CLOSING DICT 


followed by one of the next six (nn is the 
Please consult your system manager before 
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When generating reports using HP Inform/3000, the user selects the desired 
elements from HP Inform/3000's Data Names Menu. If the user has chosen to 
report from elements organized into an HP Inform/3000 group, these elements 
may exist in various files - MPE files, KSAM files, or IMAGE data sets. HP 
Inform/3000 needs to be able to link these files so that the desired lines of 
the report can be generated. 


It is important for the data base administrator to understand how HP 
Inform/3000 links the various files. The linking process determines whether 
it is possible to generate the requested report and, if so, what specific 
data will be printed in the report. 


Common elements (elements that exist in more than one file) are used to build 
links between the files which contain elements needed for the report. An 
element that is used in this way is called a "link element". 


NOTE: An element which has been defined as a CHILD element through the 
RELATE ELEMENT command string can not be used as a link. 


Before reading this appendix, you should read Using Commands to Define HP 
Inform/3000 Groups in Section III. 
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DIRECT LINKS 


A link between two files, each of which contains the values of one or more 
elements needed for a report, is called a "direct link". 


When two files are linked, the value of the link element is retrieved from 
the first file and is used to determine the correct record to retrieve from 
the second file. If the link is from an IMAGE master set, IMAGE detail set, 
KSAM file, or MPE file to an MPE file, the link element must simply exist in 
both files; if the file you are linking to, however, is an IMAGE master, 
IMAGE detail, or KSAM file, there are additional requirements on the link 
element. These are: 


(1) If the file you are linking to is a KSAM file, the link element must be 
a common element (must exist in both files) and must be a key item in 
the KSAM file. Note that when the link is from a KSAM file to another 
KSAM file, the link element need only be a key item in the second file 
accessed. 


(2) If the file you are linking to is an IMAGE detail set, the link element 
must be a common element and must be a search item in the detail set. 
These are the only requirements even when the link is from one data 
base to another. Note that when the link is from a detail set to 
another detail set, the link element need only be a search item in the 
second file accessed. 


(3) If the file you are linking to is an IMAGE master set, the link element 
must be a common element and must be a search item in the master set. 
These are the only requirements even when the link is from one data 
base to another. Note that when the link is from a master set to 
another master set, the link element need only be a search item in the 
second file accessed. (There are two additional ways that a data set 
can be linked to a master set as long as the link is within one data 
base; these are explained below under Indirect Links. ) 


The following table summarizes the above requirements for direct links 
according to what type of file is being linked to. Note that the file you 
are linking from can be any type - MPE, KSAM, IMAGE detail, or IMAGE master. 
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FILE BEING REQUIREMENT ON LINK ELEMENT 
LINKED TO 





MPE Common element. 


KSAM - Common element. which is a key item in the 
KSAM file being linked to. 


DETAIL Common element which is a search item in the 
DETAIL data set being linked to. 


MASTER Common element which is a search item in 


the MASTER data set being linked to. 


EXAMPLE 1 at the end of this appendix demonstrates direct links from an MPE 
file to a KSAM file and from an MPE file to an IMAGE detail set. 
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INDIRECT LINKS 


If two files containing elements needed for a report are linked through other 
files which contain no elements needed for the report, the link is called an 
"indirect link". There are only two indirect links which HP Inform/3000 
allows and both apply only to data sets within the same data base. These 
links are the following: 


(1) If a master set needs to be linked to another master, a link can be 
made by going through a detail which has a search item in common with 
each of the masters. For example, assume the following is a partial 
representation of a data base: 


ZONING -MASTER CITY -MASTER 







COMMERCIAL 


*zoning-code 
*city-abbr 


* search item 


Suppose the report requests the data element "zoning-des" from the 
master set ZONING-MASTER and the data element "city-name" from the 
master set CITY-MASTER. An indirect link can be made by going through 
the detail set COMMERCIAL. The master set ZONING-MASTER has the search 
item "zoning-code" which forms an IMAGE path to the detail set 
COMMERCIAL, and the master set CITY-MASTER has the search item 
"city-abbr" which also forms an IMAGE path to COMMERCIAL. 
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(2) If a detail set needs to be linked to a master set, a link can be made 
by going through a second detail which has a search item in common with 
the first detail (forming IMAGE paths to a common master) and a second 
search item forming an IMAGE path to the desired master. For example, 
assume the following is a partial representation of a data base: 


LIST-PRICE-MSTR CITY -MASTER 





RESIDENTIAL 









COMMERCTAL 





*city-abbr 
*list-price 


*list-price 
occupied 
















° 


e 





* search item 


Suppose the report requests the data element "occupied" from the detail 
set COMMERCIAL and the data element "city-name" from the master set 
CITY-MASTER. An indirect link can be formed by going through the 
detail set RESIDENTIAL. The detail set COMMERCIAL and the detail set 
RESIDENTIAL both have the search item "list-price" (which forms IMAGE 
paths to the common master set LIST-PRICE-MSTR); the detail set 
RESIDENTIAL has a second search item “city-abbr" which forms an IMAGE 
path to the master set CITY-MASTER. 


As stated earlier, these are the only two indirect links which HP Inform/3000 
allows and both apply only to data sets within one data base. 
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THE DRIVING FILE 


The driving file is the file that is accessed first. Since at least one line 
of the report will be generated for each record retrieved from the driving 
file, the contents of a report could be quite different if the driving file 
is different. Files which meet the following criteria are considered: 


(1) the file must contain an element having a positive link value (greater 
than zero) which may or may not be included in the report, and 


(2) the file must contain an element to be included in the report. 
One, none, or more than one file might meet these two criteria: 


(a) If only one file meets these two criteria, then it will be chosen as 
the driving file. 


(b) If no files meet these two criteria, then files which contain an 
element to be included in the report are considered in the following 
order: 


MPE files 
KSAM files 
IMAGE detail data sets 
IMAGE master data sets 


If more than one file exists in the highest possible category, the file 
with the most elements to be included in the report is chosen as the 
driving file. If there are two such files or more, one of them is 
arbitrarily chosen. 


NOTE: The driving file will always be read serially. It is 
desirable to use an MPE file as the driving file whenever 
there is one which contains an element to be included in 
the report; this is because HP Inform/3000 must perform a 
serial read every time it accesses an MPE file to retrieve 
a value for a line of the report. If the MPE file is the 
driving file, this serial read is done only once; if it is 
not, then a serial read is done for each value of the 
element used to link to the MPE file. This is not true for 
KSAM files or IMAGE data sets. 


(c) If more than one file meets these two criteria, the file which has the 
highest priority link value specified (lowest positive integer) is 
chosen as the driving file. If more than one of these files has the 
highest priority link value, then the driving file is chosen from among 
them as in case (b) above. 


How HP Inform/3000 Links Files 


Hence, to ensure that a particular file is the driving file whenever an 
element which exists in that file is requested for a report, add an element 
from that file to the group, specify the name of that file in response to the 
FILE prompt, and specify a positive link value in response to the VALUE AS A 
LINK prompt. The element used should be one which allows HP Inform/3000 to 
link directly with other files to obtain as many elements from the group as 
possible. The file you choose to specify in this manner should: 


(1) be an MPE file (see the NOTE earlier) if the group contains elements 
which only exist in that file or if the MPE file is needed by HP 
Inform/3000 to link directly to other files; 


(2) contain the appropriate subset of data desired for reports which will 
be generated from that group. 


If more than one file satisfies (1) or (2), specify a link value of 1 for the 
file that contains the greatest number of elements from the group, 2 for the 
file that contains the next greatest number of elements from the group, and 
so on. 


Note that the more specific or limited a group is (that is, the less varied 
the kinds of reports that will be generated from it are), the more likely it 
is that a file which meets (2), above, can be specified. 


EXAMPLE 1 at the end of this appendix demonstrates choosing a file which 
meets (1), above. EXAMPLE 2 demonstrates choosing a file which meets (2), 
above. ; 
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LINKING FILES 


All elements in a group that have been assigned a positive link value form a 
prioritized list for use by HP Inform/3000's access algorithm when linking 


files. 


Elements which have been added to a group which will not be displayed 


on HP Inform/3000's Data Names Menu are included in this list if they have 
been assigned a positive link value. The following steps outline how HP 
Inform/3000 links files. If, at any particular step, all files containing 
elements needed for the report are linked, the steps which follow that one do 
not occur. 


(1) 


(2) 


(4) 


(5) 


(6) 


HP Inform/3000 first tries to use the element in the group with the 
highest priority link value (lowest positive integer) to directly link 
the driving file with any other files containing elements needed for 
the report. 


HP Inform/3000 next tries to use the element in the group with the 
second highest priority link value to directly link those files linked 
in step (1) - that is, the driving file and any files which were 
successfully linked to it - with any other files containing elements 
needed for the report. 


Next, the element in the group with the next highest priority link 
value is used to try to directly link those files linked in steps (1) 
and (2) with any other files containing elements needed for the report; 
and so on, until the prioritized list of elements with a positive link 
value is exhausted. 


HP Inform/3000 next tries to use elements in the group with a link 
value of zero (the default) to directly link those files linked in 
steps (1), (2), and (3) with any other files containing elements needed 
for the report. The elements with a link value of zero are tried in an 
arbitrary order. 


If all the files have still not been linked successfully, HP 
Inform/3000 tries to use elements which are not in the group to 
directly link any of the files linked in steps (1), (2), (3), and (4) 
with any of the remaining files. As always, a direct link is 
successful if the element exists in both files and if any additional 
requirements on the file being linked to are met (see "Direct Links" 
earlier in this appendix). 


If still no link can be made and if the files HP Inform/3000 is 
attempting to link are IMAGE data sets, HP Inform/3000 will try the two 
allowable indirect links. If this fails to link all the needed files, 
the report can not be generated and the HP Inform/3000 user will 
receive an error message. 
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DEFAULT FILE ACCESS 


HP Inform/3000 provides defaults designed to maximize performance of the file 
accesses necessary during report production. One such default, which was 
explained in the discussion on the driving file, is that an MPE file will be 
used as the driving file whenever possible. In addition, if file names (in 
response to the FILE prompt) and link values that override the defaults have 
not been specified, HP Inform/3000 will try to follow these guidelines: 


® Involve as few files as possible in the access. 


e Access a KSAM file in preference to a data base (since there is less 
overhead involved). 


e Open as few data bases as possible. 


e Use master data sets whenever possible (since they will need to be 
accessed only once per key value, while detail data sets and KSAM files 
may require several accesses per key value). 


Note that by specifying a file name in response to the FILE prompt, HP 
Inform/3000's access algorithm may not work efficiently and possibly not at 
all. It is best to not specify a file name in response to the FILE prompt 
unless necessary to ensure that the correct values of an element are 
retrieved. If a file name is specified when it is not necessary to do so, it 
is possible that more files will be accessed than HP Inform/3000 would 
otherwise access. In the worst case, it may result in HP Inform/3000 being 
unable to create a link - when there is no link element to the designated 
file. 


HP Inform/3000 uses link elements to accomplish the above goals; the link 
elements are used in the order which produces maximum performance. The use 
of link values assigned to elements allows you to override this - to control 
which elements are tried to link files and in what order. However, the 
ability of HP Inform/3000 to maximize performance may be hampered by the 
improper use of link values. 
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EXAMPLE 1 


Assume the following files: 


SALESTAT 
(KSAM file) 


account 
(KEY ) 


ES 






ytd-sales 


owner 





Suppose we wish to create a group called ACCOUNT ORDERS. 


WARRANTY 
(MPE file) 


account 


owner 


ound 


total 
ship-date 


wrnty-no 





INVENTORY 
(IMAGE detail) 










*prod-no 
*ship-date 

backorderflg 
unit-cost 


The purpose of the 


ACCOUNT ORDERS group is to generate reports about the orders of each account. 
The group consists of the data elements: 


account 
address 
owner 
prod-no 
unit-cost 


By accessing the files SALESTAT and INVENTORY, we could obtain all the 
elements in the group; however, it is not possible to link these two files 


Since there is no element which exists in both of them. 


The MPE file, 


however, also contains elements from the group and, in particular, contains 
the element "account" which exists in the KSAM file and which is a key item 
in the KSAM file; hence a direct link can be made from WARRANTY to SALESTAT. 
In addition, the MPE file contains two elements ("prod-no" and "ship-date" ) 
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which also exist in the IMAGE detail set and which are search items in the 
IMAGE detail; hence a direct link can be made from WARRANTY to INVENTORY. 


Since the MPE file allows us to directly link to the two other files and 
since it is preferable to access an MPE file first, we want to make the MPE 
file the driving file. To accomplish this, we need to specify the file name 
WARRANTY in response to the FILE prompt and a link value of 1 in response to 
the VALUE AS A LINK prompt when adding an element from the file WARRANTY to 
the group. We would like to pick an element which will allow HP Inform/3000 
to link WARRANTY directly with other files to retrieve as many elements from 
the group as possible. 


The elements "account", "prod-no", and "ship-date" are our three 
possibilities: Since "ship-date" is not in the group, we will use "account" 
or "prod-no". The data element “account" links WARRANTY and SALESTAT, where 
"address" can be retrieved; the data element "prod-no" links WARRANTY and 


INVENTORY, where "unit-cost" can be retrieved. (Note that the values for 
"account", “owner", and "prod-no" will all be retrieved from the MPE file 
since it is accessed first.) Since both data elements allow us to link to 


one other file where one required element can be retrieved, it does not 
matter which one we use. 


After linking WARRANTY with SALESTAT through the element "account", HP 
Inform/3000 will try to use the element in the group with the next highest 
priority link value to directly link WARRANTY or SALESTAT with INVENTORY - 
assuming "prod-no" or "unit-cost" was requested for the report. To make this 
most efficient, we can give "prod-no" a link value of 2. 


Thus, we could add elements to the ACCOUNT ORDERS group as follows: 
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>»ADD GROUP 
GROUP > 
ELEMENT > 
ELEMENT ALIAS> 
FILE>! 
ELEMENT > 


ELEMENT ALIAS> 


ELEMENT > 
ELEMENT ALIAS> 


ELEMENT > 

ELEMENT ALIAS> 

FILE> 

VALUE AS A LINK> 
DISPLAY ELEMENT ON MENU 


ELEMENT > 

ELEMENT ALIAS> 

FILE> 

VALUE AS A LINK> 
DISPLAY ELEMENT ON MENU 


ELEMENT > 


account orders 
unit-cost 


cost of unit 


address 
| 


owner 


account 


warranty 
] < 
(Y/N)?>! 


prod-no 
product number 


2 < 
(Y/N)?>! 


How HP Inform/3000 Links Files 


EXAMPLE 2 


‘ 


Assume the following data base: 


LOCATION BORROWER CALL-NO SUBJECT AUTHOR TITLE 





CATALOG BOOK 



















*call-no xtitle 


*borrower *author 
bor-date *subject 
*branch xcall-no 


pub-date 
publisher 


* search item 


Suppose we wish to create a group called BOOKS OUT. The purpose of the BOOKS 
OUT group is to generate reports about books that are checked out of the 
library. The group consists of the data elements: 


title 
author 
call-no 
borrower 
phone 


Since the purpose of the BOOKS OUT group is to report on books that are 
checked out, it makes sense to access the detail set CATALOG as the first 
file; since CATALOG has only one entry for every book checked out, there will 
be at least one line of the report for each book that is checked out of the 
library. That is, CATALOG contains the appropriate subset of data which is 
desired for reports which will be generated from the BOOKS OUT group. BOOK, 
TITLE, and CALL-NO, on the other hand, have one entry for each book in the 
library; if one of these files is the first file accessed, there will be at 
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least one line of the report for every book in the library. Accessing 
BORROWER or AUTHOR as the first file would also not be satisfactory, since 
BORROWER has one entry for each person registered to check out books from the 
library and AUTHOR has one entry for each author. (SUBJECT and LOCATION are 
not considered since they do not contain any elements from the group. ) 


To make CATALOG the driving file, we need to specify the file name CATALOG in 
response to the FILE prompt and a link value of 1 in response to the VALUE AS 
A LINK prompt when adding an element from the file CATALOG to the group. We 
would like to pick an element which will allow HP Inform/3000 to link CATALOG 
directly with other files to retrieve as many elements from the group as 
possible. The elements "call-no" and "borrower" are our two possibilities 
Since they are search items. The data element "call-no" links CATALOG and 
BOOK, where "title" and "author" can be retrieved; the data element 
"borrower" links CATALOG and BORROWER, where only "phone" can be retrieved. 
Hence, we pick the element "call-no". 


After linking CATALOG and BOOK through the element "call-no", HP Inform/ 3000 
will try to use the element in the group with the next highest priority link 
value to directly link CATALOG or BOOK with BORROWER - assuming "phone" was 
requested for the report. To make this most efficient, we can give 
"borrower" a link value of 2. 


Thus, we could add elements to the BOOKS oUT group as follows: 


>ADD GROUP 
GROUP > 


ELEMENT > 
ELEMENT ALIAS> 


ELEMENT > 
ELEMENT ALIAS> 


ELEMENT > 
ELEMENT ALIAS> 
FILE> 


ELEMENT > 

ELEMENT ALIAS> 

FILE> 

VALUE AS A LINK> 
DISPLAY ELEMENT ON MENU 


ELEMENT > 

ELEMENT ALIAS> 

FILE> 

VALUE AS A LINK> 
DISPLAY ELEMENT ON MENU 


ELEMENT > 


books out 


title 
\ 


author 
| 


phone 
phone number 
| 


call-no 
call number 
catalog 

] < 
(Y/N) ?>! 


borrower 


2 < 
(Y/N) ?>! 
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APPENDIX 


GLOSSARY 
OF TERMS 


You should be familiar with the terms defined in this appendix in order to 
use Dictionary/3000. 


Glossary of Terms 


DICTIONARY/3000 TERMS 


access capability - 
The type of access to be given to a user security class for a file or 
element, as follows: 


R - allows the user identified by the security class to locate and read 
a file or an element; 


U - allows the user identified by the security clas to read and update 
values in a file or an element, except search or sort elements; 


M - allows the user identified by the security class to read, update, 
add to, and delete from a file or an element; 


X - allows only the creator to access the data set or data element; 


account - 
The name of an MPE account. (See the MPE Commands Reference manual. ) 


alias - 
An optional name you assign to an already defined entity for local use 
in programs, groups, and files. 


association - 
Ties together unlike entities such as an element and and a file. 


AUTO - 
An IMAGE automatic master data set which contains only one data item - 
the search item - and is related to one or more IMAGE detail data sets. 


BASE - 
An IMAGE data base, consisting of master data sets and/or detail data 
sets. 


blocking factor - 
The number of records per block; a block is the smallest unit of data 
transferred by the file system. 


byte position - 
The starting position for a data element within a parent data element. 


category - 
The name used to identify the natural relationships within an 
organization or a business. 


child - 
An entity which is subordinately related to another entity of the same 
type, such as: 
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CHILD CATEGORY a category that is subordinately related to another 


category; 


CHILD ELEMENT - a data element that is subordinately related to another 
data element; 


CHILD FILE - a file that is subordinately related to another file; 
CHILD GROUP - a group that is subordinately related to another group; 


class - 
A numeric value which can be assigned to data elements for the purpose 
of defining who may or may not access the file. 


class-file - 
A data dictionary entity to which data files can be assigned in order to 
define who may or may not have access to those files. 


count - 
The numeric value used to identify the number of sub-elements in a 
compound element. 


decimal - . 
The number of decimal digits to allow for a numeric type data element. 


DETL - 
An IMAGE detail data set. 


direct link - 
A link between two files, where each file contains the values of one or 
more elements needed by HP Inform/3000 for a report. 


driving file - 
The file that HP Inform/3000 accesses first when linking files in order 
to generate a report; one line of the report is generated for each 
record retrieved from the driving file. 


edit mask - 
Text used to edit the value of data elements before displaying them. 


element - 
The smallest accessible unit of data in a data base or file; the same as 
an ‘item' in IMAGE/3000. 


entry text - 
The textual information used by HP Inform/3000, Report/3000, and 
Transact/3000 when prompting for input; if no entry text has been 
specified, the primary name is used in the prompt. 


Glossary of Terms 


file - . 
A collection of logically related data elements; may be an IMAGE data 
base or set, or a KSAM, MPE, or VPLUS file. 

file-loc - 
A data dictionary entity used to document the physical location of a 
file. 


file size - 
The maximum number of records a file is allows to contain. 


form- 
The name used to identify a form for a VPLUS forms file. 


GROUP - 
A collection of data elements in the data dictionary, established for 
the users of HP Inform/3000. 


heading text - 
The textual heading used by HP Inform/3000, Report/3000, and 
Transact/3000 for labeling data elements in reports; if no heading text 
has been specified, the primary name is used. 


indirect link - 
A link between two files, each containing elements needed by HP 
Inform/3000 for a report, which is formed by linking through one or more 
other files which do not contain elements needed for the report. 


key element - 
Used to identify a data element which is the key in a KSAM file. 


KSAM - 
Refers to a KSAM file. (See the KSAM/3000 Reference Manual.) 
language - 
The name of the implementation language used to write a program, 
procedure, or subroutine. 
level - 


The identifying number used to identify the position of an entity within 
the hierarchical structure established with the RELATE command; 1 is the 
top of the structure. 


link value - 
A -l1, 0, or positive integer assigned to a data element which is used to 
specify which elements should preferably be selected by HP Inform/3000 
to link the desired elements into a logical record for reporting. 


Glossary of Terms 


location - 
A data dictionary entity which is used to document the physical location 
of data. 


lockword - 
Used to provide access to an MPE or KSAM file. (See the MPE Commands 
Reference Manual. ) 


long name - 
A fuller textual name used to identify an entity. 


MAST - 
An IMAGE manual master data set. 


measurement units - 
Identifies the unit of measure of a data element, such as days, lbs., 
etc. 


MPEF - 
An MPE file. 


parent - 
The name of an entity in a hierarchical structure which owns child 
entities. 


password - . 
Used to provide access to a file through a security system; also, 
dictionary password - allows a certain level access to a data 
dictionary. 


primary - 
The name given an entity when it is first created in the data 
dictionary; as opposed to an alias. 


procedure - 
The name used to identify a system, program, or routine which is 
recorded in the data dictionary. 


procedure-loc 
A data dictionary entity which is used to document the physical location 
of a procedure. 


relationship - 
Ties together like entities such as a child file and a parent file. 


responsibility - 
The name of the person, area, or department that is responsible for the 
integrity of an entity. 
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RETURN - 
A carriage return/line feed. 


search element - 
Used to identify an element which is a search item in an IMAGE master or 
detail data set. 


type - 
The attribute for a data element (X, I, etc.), file type for a file 
(VPLS, MAST, KSAM, etc.), or a user-definable 4-character definition for 
other entities. 

VPLS - 


Refers to a VPLUS form file. 
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The following chart indicates the order in which the data dictionary commands 
can be used. 


CREATE 


} ADD RELATE 


REPORT 
SHOW 


REPORT 
DISPLAY 
LIST 


RESEQUENCE 


RENAME 


REORDER 


UPDATE 


MODIFY 


CHANGE 


DELETE PURGE REMOVE 


SECURE 
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COMMAND/SUB-COMMAND GUIDE 


This is a quick reference guide for each command which shows what 
sub-commands can be used and what the command/sub-command does. 


ADD 


CATEGORY 


CLASS 


CLASS -FILE 


FILE 


FILE-LOC 


GROUP 


PROCEDURE 
PROCEDURE-LOC 


CHANGE 


CATEGORY 


ELEMENT 
FILE 
GROUP 


PROCEDURE 


CREATE 


CATEGORY 


CLASS 
ELEMENT 
FILE 
GROUP 


LOCATION 
PROCEDURE 


DELETE 


CATEGORY 


CLASS 


CLASS -FILE 


FILE 


FILE-LOC 


GROUP 


PROCEDURE 
PROCEDURE-LOC 


adds 
adds 
adds 
adds 
adds 
adds 
adds 
adds 


9o 99 9 9 wD 


changes 
changes 
changes 
changes 
changes 


creates 
creates 
creates 
creates 
creates 
creates 
creates 


deletes 
deletes 
deletes 
deletes 
deletes 
deletes 
deletes 
deletes 


data element to a category 

data element to a user security class 
file to a user security class 

data element to a file 

file to a physical location 

data element to an HP Inform/3000 group 
data element to a procedure 

procedure to a physical location 


a category to category description 

an element to element entry and/or description 
a file to file entry and/or description 

an HP Inform/3000 group to group description 

a procedure to procedure description 


new cateyory 

new user security class 
new data element 

new file 

new HP Inform/3000 group 
new physical location 
new procedure 
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an element to category association 

an element to class association 

a file to class association 

an element to file association 

a file to location association 

an element to HP Inform/3000 group association 
an element to procedure association 

a procedure to location association 


DISPLAY 
CATEGORY 


CLASS 
ELEMENT 


FILE 
GROUP 
LOCATION 


PROCEDURE 


HELP 


Provides brief description of any command and its sub-categories. 


displays 
the direc 
displays 
displays 
directly 
displays 
directly 
displays 
group plu 
displays 
displays 
directly 
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attribute information for a category plus all 
tly related categories 

attribute information for a user security class 
attribute information for an element plus the 
associated and/or directly related entities 
attribute information for a file plus the 
associated and/or directly related entities 
attribute information for an HP Inform/3000 

s the directly related entities 

attribute information for a physical location 
attribute information for a procedure plus the 
associated and/or directly related entities 


HELP 


sub-categories are DICTDBM command names. 


LIST 


CATEGORY 
CLASS 
ELEMENT 
FILE 
GROUP 
LOCATION 
PROCEDURE 


MODIFY 


CATEGORY 
CLASS 
ELEMENT 
FILE 
GROUP 
LOCATION 
PROCEDURE 


PURGE 





CATEGORY 
CLASS 
ELEMENT 
FILE 


GROUP 
LOCATION 
PROCEDURE 


lists the 
lists the 
lists the 
lists the 
lists the 
lists the 
lists the 


modifies 
modifies 
modifies 
modifies 
modifies 
modifies 
modifies 


purges th 
purges th 
purges th 
purges th 
purge rel 
purges th 
purges th 
purges th 


categories 

security classes 
data elements 

files 

HP Inform/3000 groups 
physical locations 
procedures 


a category 

a security class 

a data element 

a file 

an HP Inform/3000 group 
a physical location 

a procedure 


e category and all references to it 

e security class and all references to it 

e data element and all references to it 

e file and all references to it, with the option to | 
ated files and associated elements. 

e HP Inform/3000 group and all references to it 

e location and all references to it 

e procedure and all references to it 
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RELATE 

CATEGORY - relates a category to a category 

ELEMENT - relates a data element to a data element 

FILE - relates a file to a file 

GROUP - relates an HP Inform/3000 group to a group 

PROCEDURE - relates a procedure to a procedure 

REMOVE 

CATEGORY - removes the relationship between a child and a parent 
category 

ELEMENT - removes the relationship between a child and a parent 
element 

FILE - removes the relationship between a child and a parent 
file 

GROUP - removes the relationship between a child and a parent 
HP Inform/3000 group 

PROCEDURE ~ removes the relationship between a child and a parent 
procedure 

RENAME 

CATEGORY - renames an existing category 

CLASS ~ changes the existing identifying number of a security class 

ELEMENT - renames an existing data element 

FILE - renames an existing file 

GROUP - renames an existing HP Inform/3000 group 

LOCATION - renames an existing physical location 

PROCEDURE - renames an existing procedure 

REORDER 

CATEGORY ~ reorders a child category within a parent 
category's entry list 

ELEMENT - reorders a child data element within a parent data 
element's entry list 

FILE - reorders a child file within a parent file's entry list 

GROUP ~ reorders a child HP Inform/3000 group within a parent 
group's entry list 

PROCEDURE - reorders a child procedure within a parent procedure's 
entry list 


REPORT 


CATEGORY 


CLASS 


ELEMENT 
FILE 


GROUP 


PROCEDURE 


RESEQUENCE 


CATEGORY 


CLASS 
FILE 
GROUP 


PROCEDURE 


SECURE 


FILE 


SHOW 


CATEGORY 


CLASS 
ELEMENT 
FILE © 


GROUP 


LOCATION 
PROCEDURE 
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reports all the data elements associated with a category 
or with related child categories 

reports all the data elements associated with a security 
class 

reports all the data elements defined in the dictionary | 
reports all the data elements associated with a file 

or with related child files 

reports all the data elements associated with an HP 
Inform/3000 group or with related child groups 

reports all the data elements associated with a procedure 
or with related child procedures, including any owned 

by the named procedure 


resequences a data element within a category 

resequences a data element within a security class 
resequences a data element within a file 

resequences a data element within an HP Inform/3000 group 
resequences a data element within a procedure 


secures all data elements in a file to one 
user security class. 


shows all the relationships for a category 


“plus associated data elements where applicable 


shows all the associations for a user security class 
shows all the relationships for a data element 

shows all the relationships and links for a file 

plus associated data elements where applicable 

shows all the relationships for an HP Inform/3000 group 
plus associated data elements where applicable and 
access information for the group 

shows all the associations for a location 

shows all the relationships for a procedure 

plus associated data elements where applicable 
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UPDATE 


CATEGORY 
CLASS 
CLASS - FILE 
FILE 

FILE-LOC 
GROUP 
PROCEDURE 
PROCEDURE-LOC 


Reference 


- updates 
- updates 
- updates 
- updates 
- updates 
- updates 
updates 
updates 
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data 
data 
file 
data 
file 
data 
data 


element to a category association 

element to a user security class association 
to a user security class association 

element to a file association 

to a location association 

element to an HP Inform/3000 group association 
element to a procedure association 


procedure to a location association 


A 


Abbreviations, list of, 2-6 

Access capability, 4-7, 4-68, 4-78 
Access levels, C-1, C-2 

Access modes, 5-4, 5-17, 5-23, 5-29 
Account, 4-18, 4-33, 4-38 

ADD category, 3-18 

ADD class, 3-6 

ADD class-file, 3-6 

ADD file, 3-5, 3-8 

ADD file-loc, 3-15 

ADD group, 3-22 

ADD procedure, 3-14 

ADD procedure-loc, 3-15 

Alias name, 3-19, 3-22, 4-7, 4-79, 5-16 
Association entry, 2-8 

Audit report types, 5-3 

AUTO file, 3-2 


B 
BASE file, 3-2 
Blockmax, 4-13, 4-48 
Boolean connector, 3-27 
Byte position, 3-4, 4-48 


Cc 
Cancel key, 4-78 
Cancel primary path, 4-78 
Capacity, 4-13, 4-48 
CARET character, 3-27, 3-31 
CHILD alias, 4-13, 4-48 
CHILD category, 3-17, 4-13, 4-48, 4-52, 4-58 
CHILD element, 3-4, 3-8, 3-21, 4-13, 4-48, 4-52, 4-58 
CHILD file, 3-3, 3-8, 4-13, 4-48, 4-52, 4-58 
CHILD group, 3-20, 4-13, 4-48, 4-52, 4-58 
CHILD procedure, 3-12, 4-13, 4-48, 4-52, 4-58 
Class, see Security class number 
Command option, 2-3 
Command string, 2-3 
Command syntax, 2-3 
Command usage chart, 2-7, F-l 
Commands 


INDEX-1 


INDEX 


ADD, 3-5, 3-9, 3-13, 3-14, 3-15, 3-18, 3-22, 
CHANGE, 4-11 


CREATE, 3-3, 3-5, 3-8, 3-9, 3-13, 3-15, 3-17, 


DELETE, 4-22 
DISPLAY, 4-25 
HELP, 4-30 
LIST, 4-30b 
MODIFY, 4-35 
PURGE, 4-22 
RELATE, 3-4, 3-9, 3-13, 3-17, 3-21, 4-45 
REMOVE, 4-50 
RENAME, 4-53 
REORDER, 4-56 
REPORT, 4-59 
RESEQUENCE, 4-63 
SECURE, 3-6, 4-66 
SHOW, 4-69 
UPDATE, 4-74 
Commands, list of, 2-6, F-2 
Common element, D-1 
Control line, 5-11 
Count, 4-18, 4-33, 4-38 
CPU, 4-18, 4-33, 4-38 
CREATE category, 3-17 
CREATE class, 3-5 
CREATE element, 3-3, 3-8, 3-13, 3-17, 3-21 
CREATE file, 3-3, 3-8 
CREATE group, 3-21 
CREATE location, 3-15 
CREATE procedure, 3-13 
Create, data dictionary, 3-6, C-l 
Customize, data dictionary, C-3 


D 
Data Base Audit utility, 1-3, 5-3 
Data Base Creation utility, 1-3, 3-6, 5-10 
Data Base Definition utility, 1-3, 3-2, 5-16 
Data base files, 3-2 
Data Base Load utility, 1-4, 5-27 
Data Base Maintenance program, 1-2, 2-1, 3-1 
Data Base Unload utility, 1-3, 5-22 
Data Dictionary Clean utility, 1-4, 5-33 
DBSCHEMA, 5-10 
DBUTIL, 5-10, C-2 
Decimal, 4-18, 4-33, 4-38 
Default choices, 2-2, 4-1, 5-2 
Description, 4-7, 4-18, 4-49 
DETL file, 3-2 


INDEX- 2 


4-3 


3-21, 4-15 


DICTDBA program, 


1-3, 5-3 
DICTDBC program, 1-3, 3-6, 5-10 
DICTDBD program, 1-3, 3-2, 5-16 
DICTDBL program, 1-4, 5-27 
DICTDBM commands, summary, 4-2 


DICTDBM program, 1-2, 2-1, 3-1 
DICTDBM, UTIL program, 1-4, 5-33 
DICTDBU program, 1-3, 5-22 

DICTINIT program, C-1l 

DICTLIST file, 5-2 

DICTOUT file, 5-2 

Direct link, D-2 

Display element, 3-25, 4-7, 4-78, 4-79 
Driving file, 3-25, D-6 


E 

Edit attributes, 4-13, 4-38, 4-79 
Edit command, 4-13, 4-38, 4-79 
Edit description, 3-30, 4-13, 4-38, 4-79 
Edit mask, 3-31, 4-38 
Element alias, see Alias name 
Enhanced video, 2-1 
Entry text, 4-18, 4-39 
error message types, DICTDBM, A-1 
error message types, utilities, B-1l 
error message types, DICINIT, C-14 
example, of 

ADD command, 4-4 

CHANGE command, 4-11 

CREATE command, 4-15 

DELETE command, 4-22 

DICTDBA utility, 5-4, 5-5, 5-7 

DICTDBC utility, 5-13 

DICTDBD utility, 5-19, 5-20 

DICTDBL utility, 5-30, 5-31, 5-32 

DICTDBM, UTIL utility, 5-34 

DICTDBU utility, 5-25 

DISPLAY command, 4-27 

edit commands, 3-30 

edit masks, 3-31 

HELP command, 4-30a 

initialization program, C-4, C-7, C-12 

linking files, D-10, D-13 

LIST command, 4-31 

MODIFY command, 4-35 

PURGE command, 4-42 

RELATE command, 4-46 

REMOVE command, 4-50 


INDEX - 3 


RENAME command, 4-53 
REORDER command, 4-56 
REPORT command, 4-60 
RESEQUENCE command, 4-63 
SECURE command, 4-66 
selection criteria, 3-28 
SHOW command, 4-71 
UPDATE command, 4-74 


F 

Fast I/O, 5-29 

Features, 1-2 

File access, defaults, D-9 

File alias, 4-9, 4-80 

File equation, 2-1, 5-1, 5-2, C-l 

File prompt, explanation, 3-23 

File size, 4-9, 4-80 

Files 
AUTO, 3-2 
BASE, 3-2 
DETL, 3-2 
KSAM, 3-7 
MAST, 3-2 
MPEF, 3-7 
VPLS, 3-7 


G 


Generic retrieval, 3-27 
Groups, 3-19, D-1 


H 
Heading text, 4-19, 4-39 
HELP capability, 4-1, 4-30 
Hierarchical relationship, picture of, for 
categories, 3-16 
data bases, 3-3 
files, 3-3, 3-7 
groups, 3-20 
procedures, 3-12 
HP Inform/3000, 3-19, D-1l 
HP Inform/3000 group, 3-19, D-1 


INDEX - 4 


| 
IMAGE data base, 3-2 
Indirect link, D-4 
Initialization procedure, C-1l 
Initialize, data dictionary, C-1l 
Initiate, DICTDBM, 2-1 
Initiate, utilities, 5-1 


K 
Key element, 4-9, 4-80 
KSAM files, 3-7 
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BANGALORE 560 025 
Tel: 55668 

Telex: 0845-430 
Cable: BLUESTAR 
A,CH,CM,CS,E 

Blue Star Ltd. 
Band Box House 
Prabhadevi 
BOMBAY 400 025 
Tel: 422-3101 
Telex: 011-3751 
Cable: BLUESTAR 
AM 


Blue Star Ltd. 

Sahas 

4 14/2 Vir Savarkar Marg 
Prabhadevi 

BOMBAY 400 025 

Tel: 422-6155 

Telex: 011-4093 

Cable: FROSTBLUE 
A,CH,CM,CS,E,M 

Blue Star Lid. 

Kalyan, 19 Vishwas Colony 
Alkapuri, BORODA, 390 005 
Tel: 65235 

Cable: BLUE STAR 

A 


Blue Star Ltd. 

7 Hare Street 
CALCUTTA 700 001 
Tel: 12-01-31 

Telex: 021-7655 
Cable: BLUESTAR 
A.M 

Blue Star Ltd. 

133 Kodambakkam High Road 
MADRAS 600 034 

Tel: 82057 

Telex: 04 1-379 
Cable: BLUESTAR 
A.M 

Blue Star Lid. 
Bhandari House, 7th/8th Floors 
91 Nehru Place 

NEW DELHI 110 024 
Tel: 682547 

Telex: 031-2463 
Cable: BLUESTAR 
A,CH,CM,CS,E,M 

Blue Star Ltd. 

15/16:C Wellesley Rad. 
PUNE 417 011 

Tel: 22775 

Cable: BLUE STAR 

A 


Blue Star Ltd. 

1-1-117/1 Sarojini Devi Road 
SECUNDERABAD 500 033 
Tel: 70126 

Telex: 0155-459 

Cable: BLUEFROST 

AE 

Blue Star Ltd. 

T.C. 7/603 Poornima 
Maruthankuzhi 
TRIVANDRUM 695 013 
Tel: 65799 

Telex: 0884-259 

Cable: BLUESTAR 

E 


INDONESIA 

BERCA Indonesia P.T. 
P.0.Box 496/JKT. 

Ji. Abdul Muis 62 
JAKARTA 

Tel: 373009 

Telex: 46748 BERSAL IA 
Cable: BERSAL JAKARTA 
P 


BERCA Indonesia P.T. 
Wisma Antara Bidg., 17th floor 
JAKARTA 

A,CS,E,M 

BERCA Indonesia P.T. 

P.0. Box 174/SBY. 

Jl, Kutei No. 11 

SURABAYA 

Tel: 68172 

Telex: 31146 BERSAL SB 
Cable: BERSAL-SURABAYA 
A*,E,MP 


IRAQ 

Hewlett-Packard Trading S.A. 
Mansoor City 9B/3/7 
BAGHDAD 

Tel: 55 1-49-73 

Telex: 2455 HEPAIRAQ IK 
CH,CS 


IRELAND 
Hewlett-Packard Ireland Ltd. 
Kestrel House 
Clanwilliam Court 
Lower Mount Street 
DUBLIN 2, Eire 

Tel: 680424, 680426 
Telex: 30439 
A,CH,CM,CS,E,M,P 
Cardiac Services Ltd. 
Kilmore Road 

Artane 

DUBLIN 5, Eire 

Tel: (01) 35 1820 
Telex: 30439 

M 


ISRAEL 

Electronics Engineering Division 
Motorola Israel Ltd. 

16 Kremenetski Street 

P.0. Box 25016 

TEL-AVIV 67899 

Tel: 3-338973 

Telex: 33569 Motil iL 

Cable: BASTEL Tel-Aviv 
A,CH,CM,CS,E,M,P 


ITALY 

Hewlett-Packard Italiana S.p.A. 
Traversa 99C 

Giulio Petrone, 19 

|-70124 BARI 

Tel: (080) 41-07-44 

M 


Hewlett-Packard Italiana S.p.A. 
Via Martin Luther King, 38/111 
|-40132 BOLOGNA 

Tel: (051) 402394 

Telex: 511630 

CH,CM,E,MS 


Hewlett-Packard Italiana S.p.A. 
Via Principe Nicolz 43G/C 

1-95 126 CATANIA 

Tel: (095) 37-10-87 

Telex: 970291 C,P 


Hewlett-Packard Italiana S.p.A. 
Via G. Di Vittorio 9 

|-20063 CERNUSCO SUL NAVLIGLIO 
Tel: (2) 903691 , 

Telex: 334632 
A,CH,CM,CS,E,MP,P 


Hewlett-Packard Italiana S.p.A. 
Via Nuova san Rocco A 
Capodimonte, 62/A 

|-80131 NAPOLI 

Tel: (081) 7413544 
A,CH,CM,E 


Hewlett-Packard Italiana S.p.A. 
Viale G. Modugno 33 

|-16156 GENOVA PEGLI 

Tel: (010) 68-37-07 E,C 
Hewlett-Packard Italiana S.p.A. 
Via Turazza 14 

|-35100 PADOVA 

Tel: (49) 664888 

Telex: 430315 

A,CH,CM,E,MS 
Hewlett-Packard Italiana S.p.A. 
Viale C. Pavese 340 

|-00144 ROMA 

Tel: (06) 54831 

Telex: 610514 
A,CH,CM,CS,E,MS,P* 


Hewlett-Packard Italiana S.p.A. 
Corso Giovanni Lanza 94 
1-10133 TORINO 

Tel: (011) 682245, 659308 
Telex: 221079 

CH,CM,E 


JAPAN 
Yokogawa-Hewlett-Packard Ltd. 
Inoue Building 

1- 1348-3, Asahi-cho 

ATSUGI, Kanagawa 243 

Tel: (0462) 24-0451 

CM,C*,E 
Yokogawa-Hewlett-Packard Ltd. 
Sannomiya-Daiichi Seimei-Bidg. 5F 
69 Kyo-machi Chuo-ku 

KOBE 650 

Tel: (078) 392-4791 

CE 

Yokogawa-Hewlett-Packard Ltd. 
Kumagaya Asahi Yasoji Bidg 4F 
3-4 Chome Tsukuba 
KUMAGAYA, Saitama 360 

Tel: (0485) 24-6563 

CH,CM,E 
Yokogawa-Hewlett-Packard Ltd. 
Mito Mitsui Building 

1-4-73, San-no-maru 

MITO, Ibaragi 310 

Tel: (0292) 25-7470 

CH,CM,E 
Yokogawa-Hewlett-Packard Ltd. 
Sumitomo Seimei Nagoya Bldg. 
11-2 Shimo-sasajima-cho 
Nakamura-ku 

NAGOYA, Aichi 450 

Tel: (052) 571-5171 
CH,CM,CS,E,MS 
Yokogawa-Hewlett-Packard Ltd. 
Chuo Bidg., 4th Floor 

5-4-20 Nishinakajima, 5-chome 
Yodogawa-ku 

OSAKA, 532 

Tel: (06) 304-6021 

Telex: YHPOSA 523-3624 
A,CH,CM,CS,E,MP,P* 
Yokogawa-Hewlett-Packard Ltd. 
3-29-21 Takaido-Higashi 3-chome 
Suginami-ku 

TOKYO 168 

Tel: (03) 331-6111 

Telex: 232-2024 YHPTOK 
A,CH,CM,CS,E,MP,P° 
Yokogawa-Hewlett-Packard Ltd. 
3-30-4 Tsuruya-cho 
Kanagawa-ku, 

YOKOHAMA Kanagawa, 221 

Tel: (045) 312-1252 

CH,CM,E 


JORDAN 

Mouasher Cousins Company 
P.O. Box 1387 

AMMAN 

Tel: 24907, 39907 

Telex: 21456 SABCO JO 
CH,E,|M,P 


KENYA 

ADCOM Lid., inc. 

City House, Wabera Street 
P.0.Box 30635 

NAIROBI 

Tel: 331955 

Telex: 22639 

EM 


KOREA 

Samsung Electronics 
Industrial Products iv. 
76-561 Yeoksam-Dong 
Kangnam-Ku 

C.P.0. Box 2775 

SEOUL 

Tel: 555-7555, 555-5447 
Telex: K27364 SAMSAN 
A,CH,CM,CS,E,M,P 


KUWAIT 

Al-Khalidya Trading & Contracting 
P.0. Box 830 Satat 
KUWAIT 

Tel: 42-4910, 41-1726 
Telex: 2481 Areeg kt 
CHE,M 

Photo & Cine Equipment 
P.0. Box 270 Safat 
KUWAIT 

Tel: 42-2846, 42-3801 
Telex: 2247 Matin 

P 


LEBANON 
G.M. Dolmadjian 
Achratieh 

P.O. Box 165. 167 
BEIRUT 

Tel: 290293 

MP 


LUXEMBOURG 


Hewlett-Packard Belgium S.A./N.V. 


Bivd de la Woluwe, 100 
Woluwedal 

B-1200 BRUSSELS 

Tel: (02) 762-32-00 

Telex: 23-494 paloben bru 
A,CH,CM,CS,E,MP,P 


MALAYSIA 
Hewlett-Packard Sales (Malaysia) 
Sdn. Bhd. 

Suite 2.21/2.22 

Bangunan Angkasa Raya 
Jalan Ampang 

KUALA LUMPUR 

Tel: 483544 

Telex: MA31011 
A,CH,E,M,P* 

Protel Engineering 

Lot 319, Satok Road 
P.0.Box 1917 

Kuching, SARAWAK 

Tel: 53544 

Telex: MA 70904 PROMAL 
Cable: PROTELENG 

A,E,M 


MALTA 

Philip Toledo Ltd. 
Natabile Rd. 

MRIEHEL 

Tel: 447 47, 455 66 
Telex: MW.649 

P 


MEXICO . 
Hewlett-Packard Mexicana, S.A. de 
C.V. 

Avenida Periferico Sur No. 6501 
Tepepan, Xochimilco 

MEXICO CITY 23, D.F. 

Tel: (905) 676-4600 

Telex: 017-74-507 
A,CH,CS,E,MS,P 

Hewlett-Packard Mexicana, S.A. de 
C.V. 

Rio Volga 600 

Coionia del Valle 

MONTERREY, N.L. 

Tel: 78-42-93, 78-42-40, 78-42-41 
Telex: 038-410 

CH 


MOROCCO 
Dolbeau 

81 rue Karatchi 
CASABLANCA 

Tel: 3041-82, 3068-38 
Telex: 23051, 22822 
E 


Gerep 

2 rue d’Agadir 

Boite Postale 156 
CASABLANCA 

Tel: 272093, 272095 
Telex: 23 739 

P 


NETHERLANDS 
Hewlett-Packard Nederland B.V. 
Van Heuven Goedhartlaan 121 
NL 1181KK AMSTELVEEN 

P.O. Box 667 

NL1080 AR AMSTELVEEN 

Tel: (20) 47-20-21 

Telex: 13 216 
A,CH,CM,CS,E,MP,P - 
Hewlett-Packard Nederland B.V. 
Bongerd 2 

NL 2906VK CAPPELLE, A/D ljessel 
P.O. Box 41 

NL2900 AA CAPELLE, |jssel 

Tel: (10) 51-64-44 

Telex: 21261 HEPAC NL 
A,CH,CM,CS 

Koning en Hartman Electrotechnick 
B.V. 

Koperwerf 30 

2544 En den Haag 

The NETHERLANDS 

Tel: 070-210101 

Telex: 31528 

CM 


NEW ZEALAND 
Hewlett-Packard (N.Z.) Ltd. 
169 Manukau Road 

P.O. Box 26-189 

Epsom, AUCKLAND 

Tel: 687-159 

Cable: HEWPACK Auckland 
CH,CM,E,P* 
Hewlett-Packard (N.Z.) Ltd. 
4-12 Cruickshank Street 
Kilbirnie, WELLINGTON 3 

P.O. Box 9443 

Courtenay Place, WELLINGTON 
Tel: 877-199 

Cable: HEWPACK Wellington 
CH,CM,E,P 

Northrop Instruments & Systems 
Lid. 

369 Khyber Pass Road 
P.O. Box 8602 

AUCKLAND 

Tel: 794-091 

Telex: 60605 

A.M 


Northrop Instruments & Systems 
Ltd. 

110 Mandeville St. 
P.O. Box 8388 

CHRISTCHURCH 

Tel: 486-928 

Telex: 4203 
A.M 
Northrop Instruments & Systems 
Lid. 

Sturdee House 

85-87 Ghuznee Street 
P.O. Box 2406 

WELLINGTON 

Tel: 850-091 

Telex: NZ 3380 
A.M 


NORTHERN IRELAND 
Cardiac Services Company 
95A Finaghy Road South 
BELFAST BT 10 OBY 

Tel: (0232) 625-566 

Telex: 747626 

M 


NORWAY 
Hewlett-Packard Norge A/S 
Folke Bernadottesvei 50 
P.O. Box 3558 

N-5033 FYLLINGSDALEN (BERGEN) 
Tel: (05) 16-55-40 

Telex: 16621 hpnas n 
CH,CM,E 

Hewlett-Packard Norge A/S 
Oesterndalen 18 

P.O. Box 34 

N-1345 OESTERAAS 

Tel: (02) 17-11-80 

Telex: 16621 hpnas n 
A*,CH,CM,E,MS,P 


OMAN 

Khimjl Ramdas 

P.O. Box 19 

MUSCAT 

Tel: 72-22-17, 72-22-25 

Telex: 3289 BROKER MB MUSCAT 
P 


PAKISTAN 

Mushko & Company Lid. 
10, Bazar Road 

Sector G-6/4 

ISLAMABAD 

Tel: 26875 

Cable: FEMUS Rawalpindi 
AEM 

Mushko & Company Lid. 
Oosman Chambers 
Abdullah Haroon Road 
KARACHI 0302 

Tel: 511027, 512927 
Telex: 2894 MUSKO PK 
Cable: COOPERATOR Karachi 
A,E,M,P* 


PANAMA 

Electrénico Balboa, S.A. 
Calle Samuel Lewis 
Apartado 4929 

Panama 5 

Edificio “Alfa” No. 2 
CIUDAD DE PANAMA 

Tel: 64-2700 

Telex: 0383 ELECTRON PG 
A,CM,E,M,P 


a 


SALES & SUPPORT OFFICES 


Arranged aiphabetically by country 


PANAMA (Con’t.) 
Foto Internacional, S.A. 
Free Zone Colon 

Apartado 2068 

COLON 3 

Tel: 45-2333 

Telex: 379 8626, 386 8722 
P 


PERU 

Cla Electro Mécica S.A. 

Los Flamencos 145, San Isidro 
Casilla 1030 

LIMA 1 

Tel: 41-4325, 41-3703 

Telex: Pub. Booth 25306 
A,CM,E,M,P 


PHILIPPINES 

The Online Advanced Systems 
Corporation 

Rico House, Amorsolo Cor. Herrera 
Street 

Legaspi Village, Makati 

P.O. Box 1510 

Metro MANILA 

Tel: 85-35-81, 85-34-91, 85-32-21 
Telex: 3274 ONLINE 

A,CH,CS,E,M 

Electronic Specialists and 
Proponents Inc. 

690-B Epifanio de los Santos 
Avenue 

Cubao, QUEZON CITY 

P.O. Box 2649 Manila 

Tel: 98-96-81, 98-96-82, 98-96-83 
Telex: 40018, 42000 ITT GLOBE 
MACKAY BOOTH 

P 


POLAND 

Buro Informasji Technicznej 
Hewlett-Packard 

UI Stawki 2, 6P 

PLOO-950 WARSZAWA 

Tel: 39-59-62, 39-67-43 
Telex: 812453 hepa pl 


PORTUGAL 
SOQUIMICA 

Av. da Libedade 220-2 
P- 1298 LISBOA Codex 
Tel: 56 21 81, 56 21 82 
Telex: 13316 


Telectra-Empresa Técnica de 
Equipmentos Eléctricos S.a.r.1. 
Rua Rodrigo da Fonseca 103 
P.O. Box 2531 

P-LISBON 1 

Tel: (19) 68-60-72 

Telex: 12598 

CH,CS,E,P 

Mundinier 

Intercambio Mundial de Comércio 
Sarl 

P.0. Box 2761 

Avenida Antonio Augusto de Aguiar 
138 

P-LISBON 

Tel: (19) 53-21-31, 53-21-37 
Telex: 16691 munter p 

M 


PUERTO RICO 
Hewlett-Packard Puerto Rico 
P.O. Box 4407 

CAROLINA, Puerto Rico 00630 
Calle 272 Edificio 203 

Urb. Country Club 

RIO PIEDRAS, Puerto Rico 00924 
Tel: (809) 762-7255 

Telex: 345 0514 

A,CH,CS 


QATAR 

Nasser Trading & Contracting 
P.0. Box 1563 

DOHA 

Tel: 22170 

Telex: 4439 NASSER 

M 


Computearabia 

P.0. Box 2570 

DOHA 

Tel: 329515 

Telex: 4806 CHPARB 
P 


ROMANIA 

Hewlett-Packard Reprezentanta 
Boulevard Nicolae Balcescu 16 
BUCURESTI 

Tel: 130725 

Telex: 10440 


SAUDI ARABIA 

Modern Electronic Establishment 
P.O. Box 193 

AL-KHOBAR 

Tel: 44-678, 44-813 

Telex: 670136 

Cable: ELECTA AL-KHOBAR 
CH,CS,E,M,P 

Modern Electronic Establishment 
P.0. Box 1228, Baghdadiah Street 
JEDDAH 

Tel: 27-798 

Telex: 401035 

Cable: ELECTA JEDDAH 
CH,CS,E,M,P 

Modern Electronic Establishment 
P.O. Box 2728 

RIYADH 

Tel: 62-596, 66-232 

Telex: 202049 | 

CH,CS,E,M,P 


SCOTLAND 
Hewlett-Packard Ltd. 
Royal Bank Buildings 
Swan Street 

BRECHIN, Angus, Scotland 
Tel: 3101, 3102 

CH,CM 


Hewlett-Packard Ltd. 
SOUTH QUEENSFERRY 


' West Lothian, EH30 9GT 


GB-Scotland - 

Tel: (031) 3311000 
Telex: 72682 
A,CH,CM,CS,E,M 


SINGAPORE 

Hewlett-Packard Singapore (Pty.) 
Ltd. 

P.O. Box 58 Alexandra Post Office 
SINGAPORE, 9115 

6th Floor, Inchcape House 
450-452 Alexandra Road 


“SINGAPORE 0511 


Tel: 631788 

Telex: HPSGSO RS 34209 
Cable: HEWPACK, Singapore 
A,CH,CS,E,MS,P 


SOUTH AFRICA 
Hewlett-Packard South Africa (Pty.) 
Ltd. 

P.O. Box 120 

Howard Place 

Pine Park Center, Forest Drive, 
Pinelands 

CAPE PROVINCE 7450 

Tel: 53-7955, 53-7956, 53-7957 
Telex: 57-0006 
A,CH,CM,E,MS,P 


Hewlett-Packard South Africa (Pty.) 
Ltd. 

P.O. Box 37099 

Overport 

DURBAN 4067 

Tel: 28-4178, 28-4179, 28-4110 
CH,CM 


Hewlett-Packard South Africa (Pty.) 
Ltd. 

P.O. Box 33345 

Glenstantia 0010 TRANSVAAL 

1st Floor East 

Constantia Park Ridge Shopping 
Centre 

Constantia Park 

PRETORIA 

Tel: 01298-1126 

Telex: 32163 

CHE 

Hewlett-Packard South Africa (Pty.) 
Ltd. 

Private Bag Wendywood 

SANDTON 2144 

Tel: 802-5111, 802-5125 

Telex: 89-84782 

Cable: HEWPACK Johannesburg 
A,CH,CM,CS,E,MS,P 


SPAIN 

Hewlett-Packard Espafiola S.A. 
c/Entenza, 321 

E-BARCELONA 29 

Tel: (3) 322-24-51, 321-73-54 
Telex: 52603 hpbee 
A,CH,CM,CS,E,MS,P 
Hewlett-Packard Espafiola S.A. 
c/San Vicente S/N 

Edificio Albia II,7 B 

E-BILBAO 1 

Tel: (944) 423-8306, 423-8206 
A,CH,CM,E,MS 
Hewlett-Packard Espafiola S.A. 
Calle Jerez 3 

E-MADRID 16 

Tel: 458-2600 

Telex: 23515 hpe 

A,CM,E 

Hewlett-Packard Espafiola S.A. 
c/o Costa Brava 13 

Colonia Mirasierra 

E-MADRID 34 

Tel: 734-8061, 734-1162 
CH,CS,M 

Hewlett-Packard Espafiola S.A. 
Av Ramé6n y Cajal 1-9 

Edificio Sevilla 1, 

E-SEVILLA 5 

Tel: 64-44-54, 64-44-58 
Telex: 72933 

A,CM,CS,MS,P 
Hewlett-Packard Espafiola S.A. 
C/Ramon Gordillo, 1 (Entlo.3) 


.E-VALENCIA 10 


Tel: 361-1354, 361-1358 
CH,CM,P 


SWEDEN 

Hewlett-Packard Sverige AB 

Enighetsvagen 3, Fack 

P.O. Box 20502 

S-16120 BROMMA 

Tel: (08) 730-0550 

Telex: (854) 10721 MESSAGES 

Cable: MEASUREMENTS 
STOCKHOLM 

A,CH,CM,CS,E,MS,P 


Hewlett-Packard Sverige AB 
Sunnanvagen 14K 

§-22226 LUND 

Tel: (46) 13-69-79 

Telex: (854) 10721 (via BROMMA 
office) 

CH,CM 


Hewlett-Packard Sverige AB 
Vastra Vintergatan 9 

S-70344 OREBRO 

Tel: (19) 10-48-80 

Telex: (854) 10721 (via BROMMA 
office) 

CH,CM 


Hewlett-Packard Sverige AB 
Frotallisgatan 30 

S-42132 VASTRA-FROLUNDA 

Tel: (031) 49-09-50 

Telex: (854) 10721 (via BROMMA 
office) 

CH,CM,E,P 


SWITZERLAND 
Hewlett-Packard (Schweiz) AG 
Clarastrasse 12 

CH-4058 BASLE 

Tel: (61) 33-59-20 

A,CM 

Hewlett-Packard (Schweiz) AG 
Bahnhoherweg 44 

3018 BERN 

Tel: (031) 56-24-22 

CH,CM 

Hewlett-Packard (Schweiz) AG 
47 Avenue Blanc 

CH- 1202 GENEVA 

Tel: (022) 32-30-05, 32-48-00 
CH,CM,CS 

Hewlett-Packard (Schweiz) AG 
29 Chemin Chateau Bloc 

CH- 1219 LE LIGNON-Geneva 
Tel: (022) 96-03-22 

Telex: 27333 hpag ch 

Cable: HEWPACKAG Geneva 
A,CM,E,MS,P 

Hewlett-Packard (Schweiz) AG 
Zurcherstrasse 20 

Allmend 2 

CH-8967 WIDEN 

Tel: (57) 50-111 

Telex: 59933 hpag ch 

Cable: HPAG CH 
A,CH,CM,CS,E,MS,P 


SYRIA 

General Electronic Inc. 

Nuri Basha-Ahnat Ebn Kays Street 
P.0. Box 5781 

DAMASCUS . 

Tel: 33-24-87 

Telex: 11215 ITIKAL 

Cable: ELECTROBOR DAMASCUS 
E 


Middle East Electronics 
Place Azmé 

Boite Postale 2308 
DAMASCUS 

Tel: 334592 

Telex: 11304 SATACO SY 
MP 


TAIWAN 
Hewlett-Packard Far East Ltd. 
Kaohsiung Office 


‘2/F 68-2, Chung Cheng 3rd Road 


KAOHSIUNG 
Tel: 241-2318, 261-3253 
E,MS,P 


Hewlett-Packard Far East Ltd. 
Taichung Office 

#33, Cheng Tr Rd. 

10th Floor, Room 5 
TAICHUNG 

Tel: (042) 289274 


Hewlett-Packard Far East Ltd. 
Taiwan Office 

5th Floor 

205 Tun Hwa North Road 
TAIPEI 

Tel:(02) 751-0404 
Cable:HEWPACK Taipei 
A,CH,CS,E,MS,P 

Ing Lih Trading Co. 

3rd Floor 18, Po-Al Road 
TAIPE! (100) 

Tel: (02) 311-1914 
Cable: INGLIH TAIPEI 

A 


THAILAND 

Unimesa 

30 Patpong Ave., Suriwong 
BANGKOK 5 

Tel: (234-09 1) (234-092) 
Telex: TH 81160, TH 81038 
Cable: UNIMESA Bangkok 
A,C,E,M 

Bangkok Business Equipment Ltd. 
5/5-6 Dejo Road 

BANGKOK 

Tel: 234-8670, 234-8671 
Telex: 87669-BEQUIPT TH 
Cable: BUSIQUIPT Bangkok 
P 


TRINIDAD & TOBAGO 
Caribbean Telecoms Ltd. 

50/A Jerningham Avenue 

P.0. Box 732 

PORT-OF-SPAIN 

Tel: 624-4213, 624-4214 
Telex: 3235, 3272 HUGCO WG 
A,CM,E,M,P 


TUNISIA 

Tunisie Electronique 

31 Avenue de la Liberte 
TUNIS 

Tel: 280-144 

EP 

Corema 

1 ter. Av. de Carthage 
TUNIS 

Tel: 253-821 

Telex: 12319 CABAM TN 
M 


TURKEY . 
Teknim Company Lid. 
lran Caddesi No. 7 
Kavaklidere, ANKARA 
Tel: 275800 

Telex: 42155 

E 


EMA. 

Medina Eldem Sokak No.4 1/6 
Yuksel Caddesi 

ANKARA 

Tel: 175 622 

MP 


UNITED ARAB EMIRATES 
Emitac Ltd. 

P.O. Box 1641 

SHARJAH 

Tel: 354121, 354123 

Telex: 68136 Emitac SL 
CH,CS,E,M,P 


INITED KINGDOM 
ee: GREAT BRITAIN 
tORTHERN IRELAND 
iCOTLAND 


JNITED STATES 


Wabama 
lewlett-Packard Co. 

(00 Century Park South 
ite 128 

IRMINGHAM, AL 35226 
‘el: (205) 822-6802 
‘H,CM,MP 
lewlett-Packard Co. 
0. Box 4207 

1290 Whitesburg Drive, S.E. 
IUNTSVILLE, AL 35802 
“el: (205) 881-4591 
.H,CM,CS,E,M* 


\laska 

{ewlett-Packard Co. 

1577 “C” Street, Suite 252 
\NCHORAGE, AK 99510 

fel: (206) 454-3971 
3H*,CM 


Arizona 
dewlett-Packard Co. 
2336 East Magnolia Street 
>HOENIX, AZ 85034 

Tel: (602) 273-8000 
4,CH,CM,CS,E,MS 
dewlett-Packard Co. 
2424 East Aragon Road 
rUCSON, AZ 85702 

Tel: (602) 889-4631 
3H,CM,E,MS * * 


Arkansas 
Hewlett-Packard Co. 
P.O. Box 5646 

Brady Station 

LITTLE ROCK, AR 72215 


Tel: (501) 376-1844, (501) 664- 


8773 
CM,MS 


California 
Hewlett-Packard Co. 
99 South Hill Dr. 
BRISBANE, CA 94005 
Tel: (415) 330-2500 
CH,CM,CS 
Hewlett-Packard Co. 
7621 Canoga Avenue 
CANOGA PARK, CA 91304 
Tel: (213) 702-8300 
A,CH,CM,CS,E,P 
Hewlett-Packard Co. 
1579 W. Shaw Avenue 
FRESNO, CA 93771 
Tel: (209) 224-0582 
CM.MS 


Hewlett-Packard Co. 

1430 East Orangethorpe 
FULLERTON, CA 92631 

Tel: (714) 870-1000 
CH,CM,CS,E,MP 
Hewlett-Packard Co. 

5400 W. Rosecrans Boulevard 
LAWNDALE, CA 90260 

P.O. Box 92105 

LOS ANGELES, CA 90009 

Tel: (213) 970-7500 
CH,CM,CS,MP 
Hewlett-Packard Co. 

3939 Lankershim Blvd. 
NORTH HOLLYWOOD, CA 91604 
Tel: (213) 877-1282 

Regional Headquarters 


Hewlett-Packard Co. 

3200 Hillview Avenue 
PALO ALTO, CA 94304 

Tel: (415) 857-8000 
CH,CM,CS,E 
Hewlett-Packard Co. 

646 W. North Market Boulevard 
SACRAMENTO, CA 95834 
Tel: (916) 929-7222 
A*,CH,CM,CS,E,MS 
Hewlett-Packard Co. 

9606 Aero Drive 

P.O. Box 23333 SAN DIEGO, CA 
92123 

Tel: (7 14) 279-3200 
CH,CM,CS,E,MP’ 
Hewlett-Packard Co. 

Suite A 

5553 Hollister 

SANTA BARBARA, CA 93111 
Tel: (805) 964-3390 


Hewlett-Packard Co. 
3003 Scott Boulevard 
SANTA CLARA, CA 95050 
Tel: (408) 988-7000 
A,CH,CM,CS,E,MP 


Colorado 
Hewlett-Packard Co. 

24 Inverness Place, East 
ENGLEWOOD, CO 80112 
Tel: (303) 771-3455 
A,CH,CM,CS,E,MS 


Connecticut 
Hewlett-Packard Co. 

47 Barnes Industrial Road South 
P.O. Box 5007 

WALLINGFORD, CT 06492 

Tel: (203) 265-7801 
A,CH,CM,CS,E,MS 


Florida 
Hewlett-Packard Co. 
P.O. Box 24210 

2727 N.W. 62nd Street 
FORT LAUDERDALE, FL 33309 
Tel: (305) 973-2600 
CH,CM,CS,E,MP 
Hewlett-Packard Co. 
4080 Woodcock Drive, #132 
Brownett Building 
JACKSONVILLE, FL 32207 
Tel: (904) 398-0663 
CM,C*,E* ,MS** 
Hewlett-Packard Co. 
P.O. Box 13910 

6177 Lake Ellenor Drive 
ORLANDO, FL 32809 

Tel: (305) 859-2900 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 
6425 N. Pensacola Blvd. 
Suite 4, Building 1 
PENSACOLA, FL 32575 
Tel: (904) 476-8422 
A,CM,MS 
Hewlett-Packard Co. 

110 South Hoover, Suite 120 
Vanguard Bldg. 

TAMPA, FL 33609 

Tel: (813) 872-0900 
A*,CH,CM,CS,E* ,M* 


Georgia 
Hewlett-Packard Co. 
P.O. Box 105005 
2000 South Park Place 
ATLANTA, GA 30339 
Tel: (404) 955-1500 
Telex: 810-766-4890 
A,CH,CM,CS,E,MP 


Hewlett-Packard Co. 
Executive Park Suite 306 
P.O. Box 816 

AUGUSTA, GA 30907 

Tel: (404) 736-0592 
CM,MS : 


Hewlett-Packard Co. 

P.O. Box 2103 

1172 N. Davis Drive 
WARNER ROBINS, GA 31098 
Tel: (912) 923-8831 

CM,E 


Hawaii 

Hewlett-Packard Co. 
Kawaiahao Plaza, Suite 190 
567 South King Street 
HONOLULU, Hi 96813 

Tel: (808) 526-1555 
A,CH,CM,E,MS 


Idaho 

Hewlett-Packard Co. 
11311 Chinden Boulevard 
BOISE, ID 83707 

Tel: (208) 376-6000 
CH,CM,M* 


Winois 
Hewlett-Packard Co. 
211 Prospect Road 
BLOOMINGTON, IL 61701 
Tel: (309) 663-0383 
CH,CM,MS* * 


Hewlett-Packard Co. 

1100 31st Street 

DOWNERS GROVE, IL 60515 
Tel: (312) 960-5760 
CH,CM,CS 

Hewlett-Packard Co. 

5201 Tollview Drive 
ROLLING MEADOWS, IL 60008 
Tel: (312) 255-9800 
A,CH,CM,CS,E,MP 


indiana 

Hewlett-Packard Co. 

P.O. Box 50807 

7301 No. Shadeland Avenue 
INDIANAPOLIS, IN 46250 

Tel: (317) 842-1000 
A,CH,CM,CS,E,MS 


lowa 
Hewlett-Packard Co. 
5815 S.W. 5th Street 
DES MOINES, IA 50315 
Tel: (515) 243-5876 
CH,CM,MS* * 
Hewlett-Packard Co. 
2415 Heinz Road 
IOWA CITY, IA 52240 
Tel: (319) 351-1020 
CH,CM,E*,MS 


Kansas 
Hewlett-Packard Co. 
1644 S. Rock 
WICHITA, KA 67207 
Tel: (316) 265-5200 
CH,CM 


Kentucky 
Hewlett-Packard Co. 
10170 Linn Station Road 
Suite 525 ; 
LOUISVILLE, KY 40223 
Tel: (502) 426-0100 
A,CH,CM,CS,MS 


Louisiana 
Hewlett-Packard Co. 
P.O. Box 1449 

3229 Williams Boulevard 
KENNER, LA 70062 

Tel: (504) 443-6201 
A,CH,CM,CS,E,MS 


Maryland 
Hewlett-Packard Co. 
7121 Standard Drive 
HANOVER, MD 21076 
Tel: (301) 796-7700 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 
2 Choke Cherry Road 
ROCKVILLE, MD 20850 
Tel: (301) 948-6370 
Telex: 710-828-9685 
A,CH,CM,CS,E,MP 


Massachusetts 
Hewlett-Packard Co. 
32 Hartwell Avenue 
LEXINGTON, MA 02173 
Tel: (617) 861-8960 
A,CH,CM,CS,E,MP 


Michigan 
Hewlett-Packard Co. 
23855 Research Drive 
FARMINGTON HILLS, MI 48024 
Tel: (313) 476-6400 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
4326 Cascade Road S.E. 
GRAND RAPIDS, MI 49506 
Tel: (616) 957-1970 
CH,CM,CS,MS 


Minnesota 
Hewlett-Packard Co. 
2025 W. Larpenteur Ave. 
ST. PAUL, MN 55113 

Tel: (612) 644-1100 
A,CH,CM,CS,E,MP 


Mississippi 
Hewlett-Packard Co. 
P.O. Box 5028 

322 N. Mart Plaza 
JACKSON, MS 392 16 
Tel: (601) 982-9363 
CM,MS 


Missouri 
Hewlett-Packard Co. 
11131 Colorado Avenue 
KANSAS CITY, MO 64137 
Tel: (816) 763-8000 
Telex: 910-77 1-2087 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 
1024 Executive Parkway 
ST. LOUIS, MO 63141 
Tel: (314) 878-0200 
A,CH,CM,CS,E,MP 


Nebraska 
Hewlett-Packard 

7101 Mercy Road 
Suite 101, IBX Building 
OMAHA, NE 68106 

Tel: (402) 392-0948 
CM,MS 


Nevada 
Hewlett-Packard Co. 
Suite D- 130 

5030 Paradise Blvd. 
LAS VEGAS, NV 89119 
Tel: (702) 736-6610 
CM,MS** 


New Jersey 

Hewlett-Packard Co. 

Crystal Brook Professional Building 
Route 35 

EATONTOWN, NJ 07724 

Tel: (201) 542-1384 
A*,CM,C*,E*,P* 

Hewlett-Packard Co. 

W120 Century Road 

PARAMUS, NJ 07652 


. Tel: (201) 265-5000 


A,CH,CM,CS,E,MP 


Ls 
a 


Hewlett-Packard Co. 


60 New England Av. West 
PISCATAWAY, NJ 08854 
Tel: (201) 981-1199 
A,CH,CM,CS,E 


New Mexico 
Hewlett-Packard Co. 

P.O. Box 11634 

11300 Lomas Blvd.,N.E. 
ALBUQUERQUE, NM 87 123 
Tel: (505) 292-1330 
Telex: 910-989-1185 
CH,CM,CS,E,MS 


New York 
Hewlett-Packard Co. 

5 Computer Drive South 
ALBANY, NY 12205 

Tel: (518) 458-1550 
Telex: 710-444-4691 
A,CH,CM,E,MS 


‘Hewlett-Packard Co. 


9600 Main Street 
CLARENCE, NY 14031 
Tel: (716) 759-8621 
Telex: 710-523-1893 
CH 


Hewlett-Packard Co. 
200 Cross Keys Office 
FAIRPORT, NY 14450 
Tel: (7 16) 223-9950 
Telex: 510-253-0092 
CH,CM,CS,E,MS 
Hewlett-Packard Co. 
No. 1 Pennsylvania Plaza 
55th Floor 

34th Street & 8th Avenue 
NEW YORK, NY 10119 
Tel: (212) 97 1-0800 
CH,CM,CS,E*,M* 
Hewlett-Packard Co. 
5858 East Molloy Road 
SYRACUSE NY 13211 
Tel: (315) 455-2486 
A,CH,CM,E,MS 
Hewlett-Packard Co. . 
3 Crossways Park West 
WOODBURY, NY 11797 
Tel: (516) 921-0300 
Telex: 510-221-2183 
A,CH,CM,CS,E,MS 


North Carolina 
Hewlett-Packard Co. 
P.O. Box 15579 

2905 Guess Road (27705) 
DURHAM, NC 27704 

Tel: (919) 471-8466 
C,M 

Hewlett-Packard Co. 
5605 Roanne Way 
GREENSBORO, NC 27409 
Tel: (919) 852-1800 
A,CH,CM,CS,E,MS 


Ohio 
Hewlett-Packard Co. 
9920 Carver Road 
CINCINNATI, OH 45242 
Tel: (513) 891-9870 
CH,CM,CS,MS 
Hewlett-Packard Co. 
16500. Sprague Road 
CLEVELAND, OH 44130 
Tel: (216) 243-7300 
Telex: 810-423-9430 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 
962 Crupper Ave. 
COLUMBUS, OH 43229 
Tel: (614) 436-1041 
CH,CM,CS,E* 


oO 
a 


SALES & SUPPORT OFFICES 


Arranged alphabetically by country 


Ohio (Con’t) 
Hewlett-Packard Co. 
330 Progress Rd. 
DAYTON, OH 45449 
Tel: (513) 859-8202 
A,CH,CM,E*,MS 


Oklahoma 

Hewlett-Packard Co. 

P.O. Box 366 

1503 W. Gore Blvd., Suite #2 
LAWTON, OK 73502 

Tel: (405) 248-4248 

C 

Hewlett-Packard Co. 

P.O. Box 32008 

304 N. Meridan Avenue, Suite A 
OKLAHOMA CITY, OK 73107 
Tel: (405) 946-9499 
A*,CH,CM,E*,MS 
Hewlett-Packard Co. 

Suite 121 

9920 E. 42nd Street 

TULSA, OK 74145 

Tel: (918) 665-3300 

A** ,CH,CM,CS,M* 


Oregon 

Hewlett-Packard Co. 

1500 Valley River Drive, Suite 330 
EUGENE, OR 97401 

Tel: (503) 683-8075 

C 


Hewlett-Packard Co. 
9255 S. W. Pioneer Court 
WILSONVILLE, OR 97070 
Tel: (503) 682-8000 
A,CH,CM,CS,E* MS 


Pennsylvania 
Hewlett-Packard Co. 

1021 8th Avenue 

King of Prussia Industrial Park 
KING OF PRUSSIA, PA 19406 
Tel: (215) 265-7000 


“Telex: 510-660-2670 


A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
111 Zeta Drive 
PITTSBURGH, PA 15238 
Tel: (412) 782-0400 
A,CH,CM,CS,E,MP 


South Carolina 
Hewlett-Packard Co. 

P.0. Box 6442 

6941-0 N. Trenholm Road 
COLUMBIA, SC 29260 

Tel: (803) 782-6493 
CH,CM,E,MS 
Hewlett-Packard Co. 

814 Wade Hampton Bivd. 
Suite 10 

GREENVILLE, SC 29609 
Tel: (803) 232-0917 

C 


Tennessee 
Hewlett-Packard Co. 
P.O. Box 22490 

224 Peters Road 
Suite 102 
KNOXVILLE, TN 37922 
Tel: (615) 691-2371 
A*,CH,CM,MS 
Hewlett-Packard Co. . 
3070 Directors Row 
MEMPHIS, TN 38131 
Tel: (901) 346-8370 
A,CH,CM,MS 
Hewlett-Packard Co. 
Suite 103 

478 Craighead Street 
NASHVILLE, TN 37204 
Tel: (615) 383-9136 
CM,MS** 


Texas 
Hewlett-Packard Co. 
Suite 310W 

7800 Shoalcreek Blvd. 
AUSTIN, TX 78757 

Tel: (512) 459-3143 
CME 

Hewlett-Packard Co. 
Suite C-110 

4171 North Mesa 

EL PASO, TX 79902 
Tel: (915) 533-3555 
CH,CM,E* ,MS** 
Hewlett-Packard Co. 
5020 Mark IV Parkway 
FORT WORTH, TX 76106 
Tel: (817) 625-6361 
CM,C* 
Hewlett-Packard Co. 
P.O. Box 42816 
10535 Harwin Street 
HOUSTON, TX 77036 
Tel: (713) 776-6400 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. . 
3309 67th Street 

Suite 24 

LUBBOCK, TX 79413 
Tel: (806) 799-4472 
M 


Hewlett-Packard Co. 
P.O. Box 1270 

930 E. Campbell Rd. 
RICHARDSON, TX 7508 1 
Tel: (214) 231-6101 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
205 Billy Mitchell Road 
SAN ANTONIO, TX 78226 
Tel: (512) 434-8241 
CH,CM,CS,E,MS 


Utah 

Hewlett-Packard Co. 

3530 W. 2100 South Street 
SALT LAKE CITY, UT 84119 
Tel: (801) 974-1700 
A,CH,CM,CS,E,MS 


Virginia 

Hewlett-Packard Co. 

P.0. Box 9669 

2914 Hungary Spring Road 
RICHMOND, VA 23228 

Tel: (804) 285-3431 
A,CH,CM,CS,E,MS 
Hewlett-Packard Co. 

P.O. Box 4786 


3110 Peters Creek Road, N.W. 


ROANOKE, VA 24015 

Tel: (703) 563-2205 
CH,CM,E** 
Hewlett-Packard Co. 

P.0. Box 12778 

5700 Thurston Avenue 
Suite 111 

VIRGINIA BEACH, VA 23455 
Tel: (804) 460-2471 
CH,CM,MS 


Washington 
Hewlett-Packard Co. 
15815 S.E. 37th Street 
BELLEVUE, WA 98006 
Tel: (206) 643-4000 
A,CH,CM,CS,E,MP 
Hewlett-Packard Co. 
Suite A 

708 North Argonne Road 
SPOKANE, WA 99206 
Tel: (509) 922-7000 
CH,CM,CS 


West Virginia 
Hewlett-Packard Co: 

4604 MacCorkle Ave., S.E. 
CHARLESTON, WV 25304 
Tel: (304) 925-0492 
A,CM,MS 


Wisconsin 
Hewlett-Packard Co. 

150 S. Sunny Slope Road 
BROOKFIELD, Wi 53005 
Tel: (414) 784-8800 
A,CH,CM,CS,E* MP 


URUGUAY 

Pablo Ferrando S.A.C. e.1. 
Avenida Italia 2877 

Casilla de Correo 370 
MONTEVIDEO 

Tel: 80-2586 

Telex: Public Booth 901 
A,CM,E,M 

Guillermo Kraft del Uruguay S.A. 
Av. Lib. Brig. Gral. Lavalleja 2083 
MONTEVIDEO 

Tel: 234588, 234808, 208830 
Telex: 6245 ACTOUR UY 

P 


U.S.S.R. 

Hewlett-Packard Co. 
Representative Office 
Pokrovsky Blvd. 4/17 KV12 
MOSCOW 101000 Tel: 294-2024 
Telex: 7825 HEWPACK SU 


VENEZUELA 
Hewlett-Packard de Venezuela C.A. 
Apartado 50933 


_ 3A Transversal Los Ruices Norte 


Edificio Segre 

CARACAS 1071 

Tel: 239-4133 

Telex: 25146 HEWPACK 
A,CH,CS,E,MS,P 


YUGOSLAVIA 
/skra-Commerce-Representation of 
Hewlett-Packard 

Sava Centar Delegacija 30 
Milentiia Popovica 9 

11170 BEOGRAD 

Tel: 638-762 

Telex: 12042, 12322 YU SAV CEN 


Iskra-Commerce-Representation of 
Hewlett-Packard 

Koprska 46 

61000 LJUBLJANA 

Tel: 321674, 315879 

Telex: 


ZAIRE 

Computer & Industrial Engineering 
25 Avenue de la Justice 

B.P. 10-976 

Kinshasha Zaire 

GOMBE 

Tel: 32063 

Telex: 21-457 SGEKIN ZR 

CH,CS 


ZIMBABWE 

Field Technical Sales 
45 Kelvin Road, North 
P.B. 3458 

SALISBURY 

Tel: 705 231 

Telex: 4-122 RH 
C,.EMP 


FOR COUNTRIES AND 
AREAS NOT LISTED: 


CANADA 

Ontario 

Hewlett-Packard (Canada) Ltd. 
6877 Goreway Drive 
MISSISAUGA, Ontario L4V 1M8 
Tel: (416) 678-9430 

Telex: 610-492-4246 


EASTERN USA 
Maryland 
Hewlett-Packard Co. 
4 Choke Cherry Road 
Rockville, MD 20850 
Tel: (301) 258-2000 


MIDWESTERN USA 
IWinois 

Hewlett-Packard Co. 

5201 Tollview Drive 
ROLLING MEADOWS, IL 60008 
Tel: (312) 255-9800 


SOUTHERN USA 
Georgia 
Hewlett-Packard Co. 

P.O. Box 105005 

450 Interstate N. Parkway 
ATLANTA, GA 30339 

Tel: (404) 955-1500 


WESTERN USA 
California 
Hewlett-Packard Co. 
3939 Lankersim Bivd. 
LOS ANGELES, CA 91604 
Tel: (213) 877-1282 


EUROPEAN AREAS NOT 
LISTED, CONTACT 
SWITZERLAND 
Hewlett-Packard S.A. 

7 Rue du Bois-du-Lan 

CH-1217 MEYRIN 2, Switzerland 
Tel: (022) 83-81-11 

Telex: 27835 hpse 

Cable: HEWPACKSA Geneve 


EAST EUROPEAN AREAS 
NOT LISTED, CONTACT 
AUSTRIA 

Hewlett-Packard Ges.m.b.h. 
Wehlistrasse 29 

P.O. Box 7 

A-1205 VIENNA 

Tel: (222) 35- 16-210 

Telex: 135823/135066 


MEDITERRANEAN AND 
MIDDLE EAST AREAS 
NOT LISTED, CONTACT 
GREECE 

Hewlett-Packard S.A. 
Mediterranean & Middle East 
Operations 

32 Kifisias Ave. 

Atrina Center 

PARADISOS, Amaroussion 

Tel: 808-1741-4 

Telex: 21-6588 HPAT GR 
Cable: HEWPACKSA Athens 


INTERNATIONAL AREAS 
NOT LISTED, CONTACT 
OTHER AREAS 
Hewlett-Packard Co. 
Intercontinental Headquarters 
3495 Deer Creek Road 

PALO ALTO, CA 94304 

Tel: (415) 857-1501 

Telex: 034-8300 

Cable: HEWPACK 


FOR COUNTRIES ANI 
AREAS NOT LISTED, 
CONTACT: 


AFRICA 


NORTHERN AND CENT 
AFRICA 


SWITZERLAND 
Hewlett-Packard S.A. 

7 Rue du Bois-du-Lan 
CH-1217 MEYRIN 2, Switzerlanc 
Tel: (022) 98-96-51 

Telex: 27835 hpse 

Cable: HEWPACKSA Geneve 


ASIA 


HONG KONG 
Hewlett-Packard Asia Ltd. 

6th Floor, Sun Hung Kai Cente 
30 Harbor Rd. 

G.P.0. Box 795 

HONG KONG 

Tel: 5-832 3211 

Telex: 66678 HEWPA HX 
Cable: HP ASIA LTD Hong Kon 


EUROPE 
EASTERN EUROPE 


AUSTRIA 
Hewlett-Packard Ges.m.b.h. 
Wehlistrasse 29 

P.0.Box 7 

A-1205 VIENNA 

Tel: (222) 35- 16-210 
Telex: 135823/ 135066 


NORTHERN EUROPE 


THE NETHERLANDS 
Hewlett-Packard S.A. 
Uilenstede 475 

NL-1183 AG AMSTELVEEN, The 
Netherlands 

P.0.Box 999 

NL-1180 AZ AMSTELVEEN, The 
Netherlands 

Tel: 20 437771 


SOUTH EASTERN EURC 


SWITZERLAND 
Hewlett-Packard S.A. 

7 Rue du Bois-du-Lan 

CH- 1217 MEYRIN 2, Switzerland 
Tel: (022) 98-96-51 

Telex: 27835 hpse 

Cable: HEWPACKSA Geneve 
(Offices in the World Trade Cen 


MEDITERRANEAN ANI 
MIDDLE EAST 


GREECE 

Hewlett-Packard S.A. 
Mediterranean and Middle East 
Operations 

Atrina Centre 

32 Kifissias Ave. 
Amaroussion, ATHENS, Greece 
Tel: 808-0359 808-0429 
Telex: 21-6588 

Cable: HEWPACKSA Athens 


OTHER INTERNATION, 
AREAS 

Hewlett-Packard Co. 
Intercontinental Headquarters 
3495 Deer Creek Road 

PALO ALTO, CA 94304 

Tel: (415) 857-1501 

Telex: 034-8300 

Cable: HEWPACK 

August 1981 5952-6900 


MANUAL UPDATE 


MANUAL IDENTIFICATION UPDATE IDENTIFICATION 
Part Number: 32244-90001 Update Number: 1] 
Print Date: July 1982 Print Date: Nov 1982 


Title: HP3000 Computer System 
Dictionary/3000 Reference Manual 


THE PURPOSE OF THIS MANUAL UPDATE 

is to accumulate all changes to the current edition of the manual. Earlier updates, if any, are contained herein. This update 
consists of: this cover letter, a revised “List of Effective Pages,” and all new and changed pages (backup pages are provided 
when necessary). | 


CHANGED PAGES ARE IDENTIFIED 
by the date of the update at the bottom of the page and a vertical bar in the outside margin opposite the changed material. 


NEW PAGES ARE IDENTIFIED 
by the date of the update at the bottom of the page. “New” pages are those which were not present in the original edition 
of the manual. 


TO UPDATE YOUR MANUAL, 
replace change pages with the update pages and insert any new pages. Destroy all replaced pages. 


HEWLETT - 
|G | 32244-90001 


PACKARD U1182 





HEWLETT-PACKARD COMPANY 
19420 HOMESTEAD ROAD, CUPERTINO, CALIFORNIA 95014 





* 


